home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / commo453.arc / COMMO.DOC < prev    next >
Text File  |  1991-03-28  |  168KB  |  4,618 lines
  1.  
  2.  
  3.  
  4.                                    ____________
  5.  
  6.                                    {COMMO} (tm)
  7.                                    ____________
  8.  
  9.  
  10.                       "A New Standard in Telecommunications"
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                         by
  18.  
  19.                                   Fred P. Brucker
  20.  
  21.                                Post Office Box 9103
  22.                                Santa Rosa, CA 95405
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                              User Guide and Reference
  30.  
  31.  
  32.  
  33.  
  34.                                    Release 4.53
  35.  
  36.                                   March 29, 1991
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.        This program and associated documentation are the property of the
  44.        author and may not be sold without permission.  They may be freely
  45.        distributed, unaltered and as a unit, via electronic bulletin board
  46.        systems.  Permission to distribute on diskette or in any other
  47.        manner must be obtained in writing.  See the file LICENSES for
  48.        additional licensing and distribution details.
  49.  
  50.        The author does not guarantee this program to be free from defects
  51.        and may not be held responsible for loss caused by such.  Your use
  52.        of this program constitutes your acceptance of these terms.
  53.  
  54.  
  55.  
  56.  
  57.            (C)Copyright 1989,1991  Fred P. Brucker  All Rights Reserved
  58.  
  59.  
  60.  
  61.                    {COMMO} (tm)  User Guide and Reference           page ii
  62.  
  63.  
  64.        ========================
  65.        Registration Information
  66.        ========================
  67.  
  68.        {COMMO} is not a public domain program and is not free.  It is
  69.        classified as "SHAREWARE."  What this means is that you may use the
  70.        program for 30 days to determine its suitability to your
  71.        application.  If after that time you decide to continue using
  72.        {COMMO} you must pay the registration fee.
  73.  
  74.        {COMMO} is a unique program and represents a great deal of work.  A
  75.        lot of functionality has been compressed into a small package, and
  76.        more features are being added on a continuing basis.  If you find
  77.        {COMMO} useful and enjoyable, you can help support future
  78.        improvements by registering your copy.
  79.  
  80.  
  81.        A single-user license is $25.00.  A diskette containing the current
  82.        release (specify 5.25" or 3.5") will be provided for a $5.00
  83.        handling fee.  Send a check or money order (US funds) to the address
  84.        below.
  85.  
  86.        Details and a multi-user (site) license fee schedule are provided in
  87.        the file REGISTER.FRM.
  88.  
  89.        See also the enclosed file LICENSES for complete licensing,
  90.        distribution and copyright information.
  91.  
  92.        My (voice) telephone number for inquiries and support for registered
  93.        users is (707) 573-1065.  Please restrict calls to business hours
  94.        (Pacific time).
  95.  
  96.         
  97.        Thank you, and I hope you enjoy {COMMO}.
  98.  
  99.  
  100.                                              Fred P. Brucker
  101.                                              P.O. Box 9103
  102.                                              Santa Rosa, CA 95405
  103.  
  104.  
  105.  
  106.                    {COMMO} (tm)  User Guide and Reference          page iii
  107.  
  108.  
  109.        ========
  110.        Contents
  111.        ========
  112.  
  113.  
  114.           Preface . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  115.  
  116.           Principal Features  . . . . . . . . . . . . . . . . . . . . .   2
  117.                The Best Way to Learn {COMMO} Quickly  . . . . . . . . .   4
  118.  
  119.           Getting Started . . . . . . . . . . . . . . . . . . . . . . .   4
  120.                Command Line Options . . . . . . . . . . . . . . . . . .   5
  121.                {COMMO} Support Files  . . . . . . . . . . . . . . . . .   7
  122.                Saving the Support Files . . . . . . . . . . . . . . . .   8
  123.                Initialization Procedure . . . . . . . . . . . . . . . .   8
  124.                Terminal Screen  . . . . . . . . . . . . . . . . . . . .   9
  125.  
  126.           {COMMO} Key Commands  . . . . . . . . . . . . . . . . . . . .   9
  127.                [Alt-A]   ASCII Upload . . . . . . . . . . . . . . . . .   9
  128.                [Alt-B]   Send Break Signal  . . . . . . . . . . . . . .  11
  129.                [Alt-C]   Clear Screen . . . . . . . . . . . . . . . . .  11
  130.                [Alt-D]   Dialing Directory  . . . . . . . . . . . . . .  11
  131.                     Dialing Directory Entry Example . . . . . . . . . .  12
  132.                [Alt-G]   Configuration File . . . . . . . . . . . . . .  14
  133.                     Explanation of items  . . . . . . . . . . . . . . .  14
  134.                [Alt-H]   How to Use Online Help . . . . . . . . . . . .  24
  135.                     Modifying the Help File . . . . . . . . . . . . . .  24
  136.                [Alt-I]   Screen Image Save  . . . . . . . . . . . . . .  25
  137.                [Alt-K]   Scrollback . . . . . . . . . . . . . . . . . .  25
  138.                [Alt-L]   Set Terminal Parameters  . . . . . . . . . . .  26
  139.                     Parameter Descriptions  . . . . . . . . . . . . . .  26
  140.                     Setting Terminal Parameters . . . . . . . . . . . .  28
  141.                [Alt-M]   Macro Processor  . . . . . . . . . . . . . . .  29
  142.                [Alt-O]   Send Modem Initialization String . . . . . . .  29
  143.                [Alt-P]   Send Current Password  . . . . . . . . . . . .  29
  144.                [Alt-Q]   Quit Call (hang up)  . . . . . . . . . . . . .  29
  145.                [Alt-S]   Shell to DOS . . . . . . . . . . . . . . . . .  30
  146.                [Alt-U]   Multi Number Dialing . . . . . . . . . . . . .  30
  147.                [Alt-X]   Exit from {COMMO}  . . . . . . . . . . . . . .  30
  148.                [Alt-1]   Capture File Options . . . . . . . . . . . . .  31
  149.                [Alt-2]   Print Log Toggle . . . . . . . . . . . . . . .  32
  150.                [Alt-3]   Sound Control Toggle . . . . . . . . . . . . .  32
  151.                [Alt-4]   AutoBaud Toggle  . . . . . . . . . . . . . . .  32
  152.                [Alt-5]   Local Echo Toggle  . . . . . . . . . . . . . .  33
  153.                [Alt-0]   Signal Lights Toggle . . . . . . . . . . . . .  33
  154.                [Alt--]   Chat Mode Toggle  (Alt minus)  . . . . . . . .  34
  155.                [Alt-=]   Doorway Mode Toggle  . . . . . . . . . . . . .  34
  156.  
  157.           Uploading / Downloading . . . . . . . . . . . . . . . . . . .  35
  158.                {COMMO} Auto Receive . . . . . . . . . . . . . . . . . .  36
  159.  
  160.  
  161.  
  162.                    {COMMO} (tm)  User Guide and Reference           page iv
  163.  
  164.  
  165.           Programming {COMMO} Macros  . . . . . . . . . . . . . . . . .  38
  166.                Macro-id and Function Summary  . . . . . . . . . . . . .  39
  167.                Additional Macro File Rules  . . . . . . . . . . . . . .  39
  168.                Executing Macros . . . . . . . . . . . . . . . . . . . .  40
  169.                Additional Macro Execution Rules . . . . . . . . . . . .  40
  170.  
  171.           {COMMO} Macro Functions . . . . . . . . . . . . . . . . . . .  41
  172.                Function Arguments . . . . . . . . . . . . . . . . . . .  41
  173.                Description of Functions (alphabetical)  . . . . . . . .  42
  174.                Table of {COMMO} Key-id's  . . . . . . . . . . . . . . .  65
  175.                Enhanced Keyboard Key-id's . . . . . . . . . . . . . . .  66
  176.  
  177.           Appendix A   Setting Up Your Modem  . . . . . . . . . . . . .  66
  178.                Connecting two computers (null modem cable)  . . . . . .  68
  179.  
  180.           Appendix B   {COMMO} and Multi-Tasking  . . . . . . . . . . .  69
  181.                DESQview . . . . . . . . . . . . . . . . . . . . . . . .  69
  182.                OmniView . . . . . . . . . . . . . . . . . . . . . . . .  70
  183.                DoubleDOS  . . . . . . . . . . . . . . . . . . . . . . .  70
  184.  
  185.           Appendix C   Flow Control . . . . . . . . . . . . . . . . . .  71
  186.  
  187.           Appendix D   ASCII Character Representation . . . . . . . . .  72
  188.  
  189.           Appendix E   Terminal Emulation . . . . . . . . . . . . . . .  74
  190.                Printer Support  . . . . . . . . . . . . . . . . . . . .  74
  191.                ANSI-BBS Keyboard Support  . . . . . . . . . . . . . . .  75
  192.                VT102 Keyboard Simulation  . . . . . . . . . . . . . . .  75
  193.  
  194.           Appendix F   Error Message Explanations . . . . . . . . . . .  76
  195.  
  196.  
  197.  
  198.                    {COMMO} (tm)  User Guide and Reference           page 1
  199.  
  200.  
  201.        =======
  202.        Preface
  203.        =======
  204.  
  205.        {COMMO} is a general purpose telecommunications program, also called
  206.        a "terminal" program.  Use it to dial remote systems and to
  207.        communicate using a choice of terminal emulations.  Many features
  208.        are available to enhance your communications needs.
  209.  
  210.        Other than the ability to transfer ASCII text files, {COMMO} has no
  211.        internal file transfer protocols.  Instead it provides you with
  212.        powerful tools to execute external programs which specialize in this
  213.        function.
  214.  
  215.        {COMMO} will run on any PC compatible computer with at least 128k of
  216.        memory and one diskette drive.  A serial port or internal modem with
  217.        an 8250, 16450 or 16550 series UART chip is required.
  218.  
  219.        {COMMO} can be configured to work with virtually any type of modem
  220.        that supports asynchronous operations.
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.        LIST is a product of Vernon D. Buerg
  236.        DESQview is a trademark of Quarterdeck Office Systems
  237.        OmniView is a trademark of Sunny Hill Software
  238.        DoubleDOS is a trademark of SoftLogic Solutions, Inc.
  239.        DSZ is a product of Omen Technology Inc.
  240.        AutoDownload is a trademark of Omen Technology Inc.
  241.        MPt is a product of Matthew Thomas
  242.  
  243.  
  244.  
  245.                    {COMMO} (tm)  User Guide and Reference           page 2
  246.  
  247.  
  248.        ==================
  249.        Principal Features
  250.        ==================
  251.  
  252.        {COMMO} is small in size, loads rapidly and performs all functions
  253.        with great speed.
  254.  
  255.        The powerful Macro Processor allows you to:
  256.  
  257.           1)   write macro "scripts" to automate many common operations
  258.                such as logins, reading messages, uploading/downloading. 
  259.                You can sit back and watch {COMMO} do the work -- or you can
  260.                let {COMMO} perform these tasks in the middle of the night
  261.                while you sleep.
  262.  
  263.           2)   assign Function Keys, Alt Keys, Keypad Keys, etc., to send a
  264.                string to the modem, execute any DOS command, start any
  265.                macro or initiate any {COMMO} function.
  266.  
  267.           3)   edit all macros without exiting {COMMO}, using the Internal
  268.                Editor.  
  269.  
  270.        The free-form Dialing Directory has space for hundreds of entries. 
  271.        Multi Number Dialing is supported from the command line.  AutoBaud
  272.        detect adjusts to the speed of the connection.  A Macro may be
  273.        linked to each directory entry.
  274.  
  275.        Multi-tasking support.  {COMMO} is DESQview aware, operates in as
  276.        little as 50k of memory and will execute with DSZ in a 120k DV
  277.        window (depending on support file sizes).  Also supports OmniView,
  278.        DoubleDOS and others.
  279.  
  280.        Built-in ANSI-BBS and VT102 emulation.  Supports ANSI editing
  281.        functions, scrolling region, graphics character set, tab set/clear,
  282.        printing, modes, reports, etc.  Complete auto-switching VT102
  283.        keyboard support via Macro Processor.
  284.  
  285.        ASCII Upload to send messages and text files.  Features line pacing
  286.        and blank line expansion.
  287.  
  288.        The Configuration File, Dialing Directory and Macro File may be
  289.        edited with full-function Internal Editor.  String search is
  290.        available in all file windows.  Most features are fully
  291.        configurable.
  292.  
  293.        {COMMO} supports all display text modes, including 132 column
  294.        screens.
  295.  
  296.        Split-screen Chat Mode.  All program features are available while in
  297.        Chat Mode.
  298.  
  299.  
  300.  
  301.                    {COMMO} (tm)  User Guide and Reference           page 3
  302.  
  303.  
  304.        Doorway Mode lets you operate remote applications with full use of
  305.        your screen and keyboard.
  306.  
  307.        {COMMO}'s Auto Receive feature lets you configure any four strings
  308.        to automatically trigger any four macros.  Thus any protocol with a
  309.        "signature" can be set to start automatically.  Zmodem and MPt are
  310.        two examples that are pre-configured.
  311.  
  312.        Support for any four serial ports.  Port addresses and IRQ's are
  313.        configurable.  Port speeds up to 115,200 bps (hardware dependent). 
  314.        Support for NS16550A (or AF) buffered UART chip.
  315.  
  316.        Serial port signal lights may be displayed on the status line,
  317.        including send and receive.  Very useful with internal modems.
  318.  
  319.        Scrollback buffer up to 64k bytes gives instant replay of the text
  320.        that has scrolled off the screen.
  321.  
  322.        Capture Log saves all text from the screen to a disk file.  Three
  323.        different capture modes are available.
  324.  
  325.        Screen Image Save writes the current screen to a disk file.
  326.  
  327.        Print Log writes all text from the screen to the printer.
  328.  
  329.        Usage Log records date, time, length of call and other information
  330.        about each call.  Date of last call can be saved in the Dialing
  331.        Directory.
  332.  
  333.        Support for visually impaired users, including optional BIOS
  334.        Terminal Screen writes and special sounds when errors occur.
  335.  
  336.        Enhanced keyboard support.
  337.  
  338.        Extensive context-related Online Help.
  339.  
  340.  
  341.        And {COMMO} is elegant, easy to learn and fun to use!
  342.  
  343.  
  344.  
  345.                    {COMMO} (tm)  User Guide and Reference           page 4
  346.  
  347.  
  348.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  349.                     -------------------------------------
  350.                     The Best Way to Learn {COMMO} Quickly
  351.                     -------------------------------------
  352.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  353.  
  354.  
  355.        1) Read the section "Getting Started" which will get you up and
  356.           running.
  357.  
  358.        2) Read Appendix A "Setting Up Your Modem" for some very important
  359.           instructions regarding your specific hardware.
  360.  
  361.        3) Read through the section "{COMMO} Key Commands" to familiarize
  362.           yourself with {COMMO}'s commands and features.
  363.  
  364.        4) Use Online Help as a reference while you use {COMMO}.
  365.  
  366.  
  367.        How is it pronounced???  Just like "comma" (,) except for the last
  368.        letter.  It's technical jargon for "communications."
  369.  
  370.  
  371.        ===============
  372.        Getting Started
  373.        ===============
  374.  
  375.        Note: Refer to Appendix F for explanations of any error messages you
  376.        receive during your initial use of {COMMO}.
  377.  
  378.        First make sure that all of the files from the {COMMO} package are
  379.        in one directory or on one diskette.  Four of these files are
  380.        required to run the {COMMO} program: 
  381.  
  382.             COMMO.COM      the Program File
  383.             COMMO.CFG      the Configuration File
  384.             COMMO.FON      the Dialing Directory File
  385.             COMMO.MAC      the Macro File
  386.  
  387.        In addition, if Online Help is used (recommended):
  388.  
  389.             COMMO.HLP      the Online Help File
  390.  
  391.        There are two ways to make sure that {COMMO} will be able to find
  392.        all of its files.  The first method is the simplest and should be
  393.        used if you are not too familiar with DOS commands:
  394.  
  395.        1) Make sure you are logged into the directory or disk drive where
  396.           the files are located.  Then simply type "commo" at the DOS
  397.           prompt.  If your files are in the directory "C:\COMMO" you would
  398.           type:
  399.  
  400.  
  401.  
  402.                    {COMMO} (tm)  User Guide and Reference           page 5
  403.  
  404.  
  405.                c:<cr>
  406.                cd \commo<cr>
  407.                commo<cr>
  408.  
  409.           (<cr> is the [Enter] or Return key)
  410.  
  411.           Or if the files are on a diskette in drive A you would type:
  412.  
  413.                a:<cr>
  414.                commo<cr>
  415.  
  416.           {COMMO} will remember where the files are, so you will be able to
  417.           change directory or drive later without concern.
  418.  
  419.        2) The second method is a little more advanced, but allows you to
  420.           run {COMMO} no matter what directory or drive you are currently
  421.           logged into:
  422.  
  423.           Use the SET command in DOS to store the {COMMO} path into the
  424.           "environment."  If you place this command in your AUTOEXEC.BAT
  425.           file you won't have to change directories or diskettes to run
  426.           {COMMO}.  If your files are in the directory "C:\COMMO" the
  427.           command would be:
  428.  
  429.                set commo=c:\commo
  430.  
  431.           If the files are on the diskette in drive B the command would be:
  432.  
  433.                set commo=b:
  434.  
  435.           Do not use any extra spaces in the SET command.  And remember to
  436.           place the {COMMO} directory or drive in your PATH command.
  437.  
  438.           IMPORTANT:  Be sure to check your "set commo=" command if you
  439.           install {COMMO} into a different directory or onto another drive
  440.           (or if you install a later release of the program).  If it points
  441.           to the wrong directory, {COMMO} will not operate properly.  This
  442.           is a common error and can cause a lot of head scratching.
  443.  
  444.  
  445.        ====================
  446.        Command Line Options
  447.        ====================
  448.  
  449.           _______________
  450.  
  451.           Dialing Strings
  452.           _______________
  453.  
  454.        Dialing Strings may be placed before any command line switches. 
  455.        {COMMO} will search the Dialing Directory for each string and mark
  456.        the first entry where a match is found (case is ignored).
  457.  
  458.  
  459.  
  460.                    {COMMO} (tm)  User Guide and Reference           page 6
  461.  
  462.  
  463.  
  464.        The strings may consist of any part of a Dialing Directory entry
  465.        line (including passwords) and may be separated by commas or spaces. 
  466.        The following characters may not appear in a command line Dialing
  467.        String: space, comma, slash (/).
  468.  
  469.        After entries in the Dialing Directory are marked, {COMMO} will
  470.        check for a Startup Macro (see below).  If no valid macro-id is
  471.        present Multi Number Dialing of the marked systems will begin.  If a
  472.        macro is present it will be started instead.
  473.  
  474.        The Modem Initialization String will be sent before dialing begins
  475.        unless the switch "/I=no" is present on the command line.
  476.  
  477.        Examples:
  478.  
  479.                 commo telegodzilla joes-bbs 4567 
  480.  
  481.                 commo zilla,joes,4567
  482.  
  483.        IMPORTANT: Your modem should be turned on and ready to receive the
  484.        Modem Initialization String before starting the program.
  485.  
  486.           ________
  487.  
  488.           Switches
  489.           ________
  490.  
  491.        Case is ignored and the switches may be in any order (Dialing
  492.        Strings must be first, however).  The alternate forms without the
  493.        "=" must be used if switches are to be passed as batch file
  494.        parameters ("=" acts as a delimiter on the command line).
  495.  
  496.  
  497.          /C=filename or /Cfilename      default:  COMMO.CFG
  498.  
  499.        Alternate Configuration File.  The alternate file must reside in the
  500.        {COMMO} home directory.
  501.  
  502.  
  503.          /I=[yes/no] or /I[yes/no]      default:  none
  504.  
  505.        This switch may be used to inhibit the Modem Initialization when
  506.        Dialing Strings and/or a Startup Macro are present: "/I=no."
  507.  
  508.        It may also be used to bypass the question "Initialize modem?" on
  509.        the Initialization Screen: "/I=yes" or "/I=no."
  510.  
  511.  
  512.  
  513.                    {COMMO} (tm)  User Guide and Reference           page 7
  514.  
  515.  
  516.          /M=macro-id or /Mmacro-id      default:  none
  517.  
  518.        Startup Macro.  The "macro-id" is a three character macro
  519.        identifier.  If the macro is found in the Macro File it will be
  520.        started.  If the macro is not found the switch will be ignored.
  521.  
  522.        The Modem Initialization String will be sent before starting the
  523.        macro unless the switch "/I=no" is present on the command line. 
  524.  
  525.  
  526.        Example:
  527.  
  528.                  commo joes zilla /c=other.cfg /m=abc
  529.  
  530.        Two systems will be marked in the Dialing Directory.  The alternate
  531.        Configuration File "other.cfg" will be used (it must be located in
  532.        the {COMMO} home directory).  The macro "abc" will be started if it
  533.        exists in the Macro File.
  534.  
  535.  
  536.        =====================
  537.        {COMMO} Support Files
  538.        =====================
  539.  
  540.        The {COMMO} files are standard ASCII text files and may be modified
  541.        with any editor (or word processor in "non-document" mode).  In
  542.        addition all but the Online Help File may be edited with {COMMO}'s
  543.        Internal Editor.
  544.  
  545.        Key definitions for the Internal Editor are given in Online Help.  A
  546.        Color Chart will be displayed in the editor when F10 is pressed
  547.        (useful in the Configuration File and for the DISPlay function in
  548.        the Macro File).
  549.  
  550.        NOTE: {COMMO} generally retains the files in memory during program
  551.        operation.  If you use an external editor to modify them while in
  552.        the Shell to DOS (or using the EXEC macro function), your changes
  553.        could be lost.  See "Saving the Support Files" below.
  554.  
  555.        Following is a brief description of each file. 
  556.  
  557.        1) COMMO.CFG.  The Configuration File contains settings for many
  558.           important parameters.  The first time you run {COMMO} you should
  559.           use the Alt-G key command to edit this file to your own needs. 
  560.           See "Alt-G  Configuration File" for details on each item.
  561.  
  562.        2) COMMO.FON.  The Dialing Directory File.  This file contains
  563.           information about the systems you will be calling, including the
  564.           telephone numbers, passwords, macro link and serial port
  565.           parameters.  Use the Alt-D key command to dial numbers and to
  566.           edit this file.  Details are given in the section "Alt-D  Dialing
  567.           Directory."
  568.  
  569.  
  570.  
  571.                    {COMMO} (tm)  User Guide and Reference           page 8
  572.  
  573.  
  574.  
  575.        3) COMMO.MAC.  The Macro File.  Use the Alt-M key command to select
  576.           a macro for execution and to edit this file.  A complete
  577.           description of {COMMO} macros is given in the section
  578.           "Programming {COMMO} Macros" in this document.  A summary of
  579.           macro functions and key designators is also given in Online Help.
  580.  
  581.        4) COMMO.HLP.  The Online Help File.  This file contains the
  582.           information for {COMMO}'s context-related Online Help.  See "How
  583.           to Use Online Help" later in this document.
  584.  
  585.  
  586.        Saving the Support Files
  587.        ========================
  588.  
  589.        Whenever a change is made to any support file (by {COMMO} or by  
  590.        you), the internal change flag is set for that file.  Changed files
  591.        will automatically be saved to disk whenever necessary, usually when
  592.        you exit the program.
  593.  
  594.        You may press Alt-F in the Internal Editor to immediately save any
  595.        file.
  596.  
  597.        If you do not wish to save your changes to the Dialing Directory or
  598.        Macro File, you may press Alt-Q while in the Internal Editor.  This
  599.        will reset {COMMO}'s change flag and the file will not be saved when
  600.        exiting the program.  Any subsequent changes to the file will set
  601.        the change flag again.
  602.  
  603.  
  604.        ========================
  605.        Initialization Procedure
  606.        ========================
  607.  
  608.        When {COMMO} begins running it will process the Configuration File. 
  609.        Then it will attempt to load into memory:
  610.  
  611.           (1) the Dialing Directory     COMMO.FON
  612.           (2) the Macro File            COMMO.MAC
  613.  
  614.        Any problems encountered will be reported.  These problems must be
  615.        corrected before restarting the program.
  616.  
  617.        Automatic modem initialization will occur if Dialing Strings are
  618.        present (and matches are found), or if the Startup Macro Switch is
  619.        present (see "Command Line Options").
  620.  
  621.        Otherwise you will be asked if you want to initialize your modem. 
  622.        Answer "yes" unless you are already on line.
  623.  
  624.        Please note that {COMMO} does NOT change the video display mode. 
  625.        Instead {COMMO} can adapt to any text mode that is set when the
  626.  
  627.  
  628.  
  629.                    {COMMO} (tm)  User Guide and Reference           page 9
  630.  
  631.  
  632.        program is started.  Check the items under "Video and Chat Mode" in
  633.        the Configuration File for details.  See also the section "[Alt-G] 
  634.        Configuration File" later in this document.
  635.  
  636.        If the display does not look right try executing the DOS command 
  637.        "mode co80" or "mode bw80" prior to calling {COMMO}.
  638.  
  639.  
  640.        ===============
  641.        Terminal Screen
  642.        ===============
  643.  
  644.        The Terminal Screen allows you to see the characters coming in from
  645.        the serial port.  Any characters that you type will be sent out to
  646.        the serial port.  If you are connected to another system you will be
  647.        interacting with that system.
  648.  
  649.        Keep in mind that you will also be interacting with {COMMO} and with
  650.        your own computer via key commands (Alt keys, for example).  These
  651.        key commands have no effect on the remote system unless they cause
  652.        characters to be sent to the serial port (pressing Alt-P to send
  653.        your password, for example).
  654.  
  655.  
  656.        ====================
  657.        {COMMO} Key Commands
  658.        ====================
  659.  
  660.        The Alt Keys shown in this section are the built-in default key
  661.        assignments for the various {COMMO} commands.  Once you are familiar
  662.        with these commands you may use the Macro Processor to reassign any
  663.        of the keys.
  664.  
  665.        Keys used within the various command windows are properly detailed
  666.        in Online Help.  Please press Alt-H from any command window to
  667.        invoke {COMMO}'s context-related help system.
  668.  
  669.        Note that certain features are only available as macro functions. 
  670.        Read the section "Programming {COMMO} Macros" for details.
  671.  
  672.  
  673.        ======================
  674.        [Alt-A]   ASCII Upload
  675.        ======================
  676.  
  677.        This command is used to send prepared messages or any text files to
  678.        the remote system.  Enter the pathname of the file you wish to send.
  679.  
  680.        There is no special error checking associated with ASCII Upload.  It
  681.        is intended primarily for sending message responses and other short
  682.        text files.  For longer files, binary files or compressed files
  683.  
  684.  
  685.  
  686.                    {COMMO} (tm)  User Guide and Reference           page 10
  687.  
  688.  
  689.        (.ARC, .ZIP) you will want to use error checking protocols such as
  690.        Zmodem or MPt.  See "Uploading / Downloading."
  691.  
  692.        A number of parameters are used to control an ASCII Upload:
  693.  
  694.           ___________
  695.  
  696.           Line Pacing
  697.           ___________
  698.  
  699.        IMPORTANT: Line Pacing is used to keep transmitted data synchronized
  700.        with received (echoed) data and is normally used ONLY when the
  701.        remote is sending a prompt for each line, usually "nn:" or "nn?". 
  702.        "nn" is a line number and ":" or "?" is the prompt or "pacing
  703.        character."
  704.  
  705.        {COMMO} will wait up to 5 seconds for the pacing character, then
  706.        send the next line.  If there is a 5 second delay between the
  707.        sending of each line, then either you have the wrong pacing
  708.        character or you don't need line pacing (you don't need it when
  709.        using a full-screen editor, for example).
  710.  
  711.        At any time, the Spacebar may be pressed to force transmission of
  712.        the next line.  This is very useful when you have set the wrong
  713.        pacing character or if you wish to send each line manually.  In the
  714.        latter case, use any pacing character that is different from the one
  715.        in the line prompt.
  716.  
  717.        To use line pacing, enter the pacing character when {COMMO} asks for
  718.        it in the ASCII Upload window.  
  719.  
  720.        The initial pacing character is configurable.  See "[Alt-G] 
  721.        Configuration File."
  722.  
  723.        The pacing character may be any character including control
  724.        characters, e.g. "^m" or "|" for carriage return.  See Appendix D
  725.        for details on how to represent special characters.
  726.  
  727.        See also Appendix C "Flow Control."
  728.  
  729.           ________________
  730.  
  731.           Character Pacing
  732.           ________________
  733.  
  734.        You may insert a delay between each character using the Inter-
  735.        Character Delay feature.  This should only be used when the remote
  736.        is so slow that characters are dropped.  See "Set Terminal
  737.        Parameters" for details.
  738.  
  739.  
  740.  
  741.                    {COMMO} (tm)  User Guide and Reference           page 11
  742.  
  743.  
  744.           ___________________
  745.  
  746.           Stripping Linefeeds
  747.           ___________________
  748.  
  749.        Normally you will want to strip linefeeds from your outgoing text. 
  750.        This will appear to the remote as if you are typing the data.  But
  751.        if all your data displays on the same line at the remote, then you
  752.        must configure {COMMO} to send the linefeeds.
  753.  
  754.        Note: This is a Configuration File item.
  755.  
  756.           _____________________
  757.  
  758.           Expanding Blank Lines
  759.           _____________________
  760.  
  761.        You may configure {COMMO} to send a space character whenever a blank
  762.        line is encountered in the text file you are sending.  This will
  763.        prevent your message from terminating prematurely if you are sending
  764.        to a BBS message editor.  Blank line expansion is not normally
  765.        required when sending to a "full screen" BBS editor.
  766.  
  767.        Note: This is a Configuration File item.
  768.  
  769.  
  770.        ===========================
  771.        [Alt-B]   Send Break Signal
  772.        ===========================
  773.  
  774.        A one second Break Signal will be sent.  This signal is used by some
  775.        systems to interrupt certain operations, such as continuous output.
  776.  
  777.  
  778.        ======================
  779.        [Alt-C]   Clear Screen
  780.        ======================
  781.  
  782.        The Terminal Screen will be cleared and the current colors will be
  783.        set to the Configuration File defaults.
  784.  
  785.  
  786.        ===========================
  787.        [Alt-D]   Dialing Directory
  788.        ===========================
  789.  
  790.        The Dialing Directory is your data base of telephone numbers.  From
  791.        the directory window you can select numbers to dial and also update
  792.        the directory using the Internal Editor.
  793.  
  794.        Refer to Online Help for a complete description of the commands
  795.        available in the Dialing Directory window.
  796.  
  797.  
  798.  
  799.                    {COMMO} (tm)  User Guide and Reference           page 12
  800.  
  801.  
  802.  
  803.        _______________________________
  804.  
  805.        Dialing Directory Entry Example
  806.        _______________________________
  807.  
  808.  
  809.          System       Telephone    System    Linked   Serial Port   Last
  810.          Name         Number       Password  Macro    Parameters    Called
  811.        _____________  __________  _________   _____  ____________  ________
  812.  
  813.        File City BBS  {555-1234}  {aardvark}  {abc}  {2400,8n1,1}  05/20/90
  814.  
  815.  
  816.        IMPORTANT: Items in curly braces must be present (they are
  817.        positional).  Items which are not used must have a null string {} as
  818.        a placeholder.  You may omit null strings at the end of the line.
  819.  
  820.        Directory entries are limited to one per line (up to 255
  821.        characters).
  822.  
  823.        Comments may be placed anywhere outside the curly braces or on
  824.        separate lines.
  825.  
  826.        ______________________________
  827.  
  828.        System Name      File City BBS
  829.        ______________________________
  830.  
  831.           Up to 40 characters in length,  it must NOT be enclosed in curly
  832.           braces.  The System Name will be displayed on the Status Line
  833.           after connection, unless the Signal Lights option is selected. 
  834.           It will also be part of a Usage Log entry if the log is enabled.
  835.  
  836.        ______________________________________
  837.  
  838.        Telephone Number      {1-707-555-1234}
  839.        ______________________________________
  840.  
  841.           Spaces and hyphens are ignored by most modems.  The Dialing
  842.           Prefix, Telephone Number and Dialing Suffix are used to form a
  843.           dialing command.  Refer to your modem manual for details on
  844.           dialing commands.
  845.  
  846.           The Dialing Prefix may be chosen from a list of four in the
  847.           Configuration File and is indicated by #1,#2,#3 or #4.  The
  848.           prefix code must appear right after the left curly brace:
  849.  
  850.                {#2 1-707-555-1234}     Use prefix 2
  851.  
  852.           Dialing Prefix 1 is the default if none is specified.
  853.  
  854.  
  855.  
  856.                    {COMMO} (tm)  User Guide and Reference           page 13
  857.  
  858.  
  859.           The Telephone Number is limited to 40 characters, excluding any
  860.           prefix code.
  861.  
  862.        _________________________________
  863.  
  864.        System Password      {mypassword}
  865.        _________________________________
  866.  
  867.           A different Password String may be defined for each system that
  868.           you call.  Passwords may be up to 64 characters in length.
  869.  
  870.           The Password String may be sent using Alt-P or by using the #
  871.           symbol in a SEND macro function.
  872.  
  873.           Passwords are invisible in the Dialing Directory window, but
  874.           appear when you enter [E]dit mode.
  875.  
  876.           Rules for writing passwords are in Appendix D.
  877.  
  878.        _______________________
  879.  
  880.        Linked Macro      {abc}  
  881.        _______________________
  882.  
  883.           If a valid Linked Macro is specified, it will be started (as a
  884.           GOTO) when a connection is established with the remote system. 
  885.           If no macro is specified (or the macro-id is invalid), {COMMO}
  886.           will enter the Terminal Screen.
  887.  
  888.        ________________________________________
  889.  
  890.        Serial Port Parameters      {2400,8n1,1}
  891.        ________________________________________
  892.  
  893.           {Speed,Format,Comport}
  894.  
  895.           This item allows you to override the default settings for the
  896.           current call.  Include only the parameters that are different
  897.           from the settings in your Configuration File.
  898.  
  899.           For example you might have "{,7}", which would set the Data
  900.           Format to "7e1", but use the default settings for the other
  901.           parameters.
  902.  
  903.           See "Set Terminal Parameters" for a complete description of each
  904.           field.  See also "AutoBaud Detect."
  905.  
  906.  
  907.  
  908.                    {COMMO} (tm)  User Guide and Reference           page 14
  909.  
  910.  
  911.        _________________________
  912.  
  913.        Last Called      05/20/90
  914.        _________________________
  915.  
  916.           If this item is present, {COMMO} will replace it with the current
  917.           date whenever a connection is made with the system.  It may
  918.           appear anywhere on the entry line (outside the curly braces). 
  919.           Place "00/00/00" to start it.  The Dialing Directory file will be
  920.           saved to disk when you exit {COMMO}.
  921.  
  922.        See also "[Alt-U]  Multi Number Dialing."
  923.  
  924.  
  925.        ============================
  926.        [Alt-G]   Configuration File
  927.        ============================
  928.  
  929.        Pressing Alt-G brings up the Configuration File in edit mode (see
  930.        "Internal Editor" in Online Help for details).
  931.  
  932.        The Configuration File contains settings for many parameters used by
  933.        {COMMO}.  Some of these are "initial" or "start" values only and are
  934.        controlled during a session with key commands.  Others (marked with
  935.        a "*" in the sample file) may be changed for the current session
  936.        using the Internal Editor.
  937.  
  938.        Each item in the Configuration File is enclosed in curly braces and
  939.        must be present even if the contents are "null."  A null item would
  940.        look like this: {}.  All text outside the curly braces is commentary
  941.        and is ignored by {COMMO}.
  942.  
  943.  
  944.        Explanation of items
  945.        ====================
  946.  
  947.        _________________________________________________________
  948.  
  949.        1 * {2400,8n1,1}
  950.  
  951.           Default Serial Port Parameters: {Speed,Format,Comport}
  952.        _________________________________________________________
  953.  
  954.           These default values will be set at program startup and each time
  955.           dialing begins.  Use the "Serial Port Parameters" item in the
  956.           Dialing Directory to set overrides for the current call.  Use
  957.           Alt-L or the macro function PARMs to set parameters at other
  958.           times.
  959.  
  960.           See "Set Terminal Parameters" for a complete description of each
  961.           field.
  962.  
  963.  
  964.  
  965.                    {COMMO} (tm)  User Guide and Reference           page 15
  966.  
  967.  
  968.        _____________________________________________________
  969.  
  970.        2 * {A}    Default Terminal-Type (Ansi-bbs/Vt102/Tty)
  971.        _____________________________________________________
  972.  
  973.           This default value will be set at program startup and each time
  974.           dialing begins.  Use Alt-L or the macro function TERMinal to
  975.           change it at other times.
  976.  
  977.           See "Set Terminal Parameters" for a complete description.
  978.  
  979.        ________________________________________________
  980.  
  981.        3 * {0}    Default Inter-Character Delay (0-999)
  982.        ________________________________________________
  983.  
  984.           This default value will be set at program startup and each time
  985.           dialing begins.  Use Alt-L or the macro function DELAy to change
  986.           it at other times.
  987.  
  988.           See "Set Terminal Parameters" for a complete description.
  989.  
  990.        _____________________________________________
  991.  
  992.        4 * {no}    Drop DTR and RTS on exit (yes/no)
  993.        _____________________________________________
  994.  
  995.           Leave this "no" if you want to exit {COMMO} and return while
  996.           still connected to a host.  "Yes" will normally cause the modem
  997.           to hang up when exiting.
  998.  
  999.        ______________________________________________________
  1000.  
  1001.        5 * {yes}    Software (XON/XOFF) Flow Control (yes/no)
  1002.        6 * {no}     Hardware (RTS/CTS) Flow Control (yes/no)
  1003.        ______________________________________________________
  1004.  
  1005.           These are used to control the flow of data between your computer
  1006.           and the remote system.  They prevent loss of data when one end
  1007.           can send faster than the other end can process information.  See
  1008.           Appendix C for details.
  1009.  
  1010.        __________________________________________
  1011.  
  1012.        7 * {~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |}
  1013.  
  1014.           Modem Init String (2400 bps and higher)
  1015.        __________________________________________
  1016.  
  1017.           This string (up to 128 characters) is normally sent to your modem
  1018.           when {COMMO} is started or when you press Alt-O.
  1019.  
  1020.  
  1021.  
  1022.                    {COMMO} (tm)  User Guide and Reference           page 16
  1023.  
  1024.  
  1025.           If you are using a 1200 bps modem you should remove the "&C1 &D2"
  1026.           commands.  In either case the "X" command may have to be
  1027.           adjusted.  See Appendix A "Setting Up Your Modem."
  1028.  
  1029.        ___________________________________________
  1030.  
  1031.         8 * {.z.,^xB00}       Auto Receive, Zmodem
  1032.         9 * {.m.,^v^h^vMPt}   Auto Receive, MPt
  1033.        10 * {.m.,^v^h^vPuma}  Auto Receive, Puma
  1034.        11 * {}                Auto Receive
  1035.        ___________________________________________
  1036.  
  1037.           The general form of this item is:  {macro-id,string}.  When the
  1038.           specified string (up to 32 characters, case ignored) is received,
  1039.           the macro will be started.  These are normally used for
  1040.           automatically starting downloads, but may be used to trigger any
  1041.           macro upon receiving any string.
  1042.  
  1043.           Set the item to null {} to disable it.  Operates in Terminal Mode
  1044.           only (use GOLOok/LOOKfor in macros).
  1045.  
  1046.        ___________________________________________________
  1047.  
  1048.        12 * {}    Com1    Port address and IRQ overrides.
  1049.        13 * {}    Com2      These are normally left blank.
  1050.        14 * {}    Com3      Refer to COMMO.DOC for
  1051.        15 * {}    Com4      important details.
  1052.        ___________________________________________________
  1053.  
  1054.           Port I/O addresses and IRQ numbers are determined as follows:
  1055.  
  1056.           If there is an address in the DOS port table for the requested
  1057.           serial port, then that address will be used.  Otherwise the
  1058.           {COMMO} default address will be used.  Default base addresses and
  1059.           IRQ numbers for each port (in hex) are:
  1060.  
  1061.                Com#   Address   IRQ
  1062.  
  1063.                  1     3f8       4
  1064.                  2     2f8       3
  1065.                  3     3e8       4
  1066.                  4     2e8       3
  1067.  
  1068.           Port base address and/or IRQ no. may always be overridden.  For
  1069.           example to set Com4, port address = 238, IRQ = 5:
  1070.  
  1071.                {238,5}    Com4
  1072.  
  1073.           Your serial adapter manual may give a range of addresses, for
  1074.           example "3f8-3ff."  Use the first value as the base address.
  1075.  
  1076.  
  1077.  
  1078.                    {COMMO} (tm)  User Guide and Reference           page 17
  1079.  
  1080.  
  1081.           After changing these with the Internal Editor you must use Alt-L
  1082.           to re-initialize the port for the current session (just enter and
  1083.           exit the Alt-L window and {COMMO} will make the necessary
  1084.           adjustments).
  1085.  
  1086.        ___________________________________________________
  1087.  
  1088.        16   {no}    Start with AutoBaud Detect on (yes/no)
  1089.        ___________________________________________________
  1090.  
  1091.           Determines the initial state of the AutoBaud toggle.  See
  1092.           "AutoBaud Detect."
  1093.  
  1094.        ________________________________________________________________
  1095.  
  1096.        17 * {yes}    Clear dialing marks when saving directory (yes/no)
  1097.        ________________________________________________________________ 
  1098.  
  1099.           If this is "yes", dialing marks will not be written to disk when
  1100.           saving the Dialing Directory file.  Set it to "no" if you wish
  1101.           the marks to be saved with the file (to be used in the next
  1102.           session).
  1103.  
  1104.           Note that changes to dialing marks (mark or unmark) will not
  1105.           cause the file to be saved upon exit from {COMMO}.  If no other
  1106.           changes occur (such as Date Last Called), you must use Alt-F in
  1107.           the Internal Editor to save the marks.
  1108.  
  1109.        _____________________________________________
  1110.  
  1111.        18 * {45}    Dialing cycle time-out (seconds)
  1112.        _____________________________________________
  1113.  
  1114.           The maximum time to wait before hanging up and redialing.  Adjust
  1115.           if your modem needs more time to complete a call.
  1116.  
  1117.        ____________________________________________________
  1118.  
  1119.        19 * {2}    Delay between dialing attempts (seconds)
  1120.        ____________________________________________________
  1121.  
  1122.           Amount of time to wait between dialing attempts.  Adjust to give
  1123.           incoming calls a greater chance of getting through.
  1124.  
  1125.  
  1126.  
  1127.                    {COMMO} (tm)  User Guide and Reference           page 18
  1128.  
  1129.  
  1130.        ________________________________________________________________
  1131.  
  1132.        20 * {CONNECT}                       Dialing success response(s)
  1133.        21 * {BUSY,NO CARRIER,NO DIALTONE}   Dialing failure response(s) 
  1134.        ________________________________________________________________
  1135.  
  1136.           These response codes can be found in your modem manual.  Do not
  1137.           include the speed in the CONNECT response if you are enabling
  1138.           AutoBaud.
  1139.  
  1140.           Responses are case sensitive.  Maximum length of each response
  1141.           set is 80 characters.  There should be no null strings or extra
  1142.           spaces.
  1143.  
  1144.        _______________________________________________________
  1145.  
  1146.        22 * {ATDT}    Dial Prefix #1 (default) see Online Help
  1147.        23 * {}        Dial Prefix #2
  1148.        24 * {}        Dial Prefix #3
  1149.        25 * {}        Dial Prefix #4
  1150.        26 * {|}       Dial Suffix
  1151.        _______________________________________________________
  1152.  
  1153.           These strings (up to 32 characters each) are used to create the
  1154.           dialing command.  The prefix, telephone number and suffix will be
  1155.           strung together in that order and sent to your modem.
  1156.  
  1157.           Any one of the four prefixes may be selected in the telephone
  1158.           number string (see "Dialing Directory").  The default is #1.
  1159.  
  1160.           Use "ATDP" if you don't have a tone line.  Use "ATDT9," to get an
  1161.           outside line on a switchboard.  The suffix is usually just a
  1162.           carriage return (|).  Your modem manual has additional tips on
  1163.           dialing prefixes and suffixes.
  1164.  
  1165.        __________________________________________
  1166.  
  1167.        27 * {c:\commo}    Path to find uploads
  1168.        28 * {c:\commo}    Path to place downloads
  1169.        __________________________________________
  1170.  
  1171.           The upload path will appear in the ASCII Upload window and will
  1172.           also be substituted for "%u" in EXECute macro functions.
  1173.  
  1174.           The download path will be substituted for "%d" in EXECute macro 
  1175.           functions.
  1176.  
  1177.  
  1178.  
  1179.                    {COMMO} (tm)  User Guide and Reference           page 19
  1180.  
  1181.  
  1182.        ______________________________________________________________
  1183.  
  1184.        29   {c:\commo\commo.cap}    Pathname for initial Capture File
  1185.        ______________________________________________________________
  1186.  
  1187.           If a filename only (no path) is specified, the current directory
  1188.           will be used.  The Capture File pathname is substituted for "%c"
  1189.           in EXECute macro functions.  See also "Capture File Options."
  1190.  
  1191.        _________________________________________
  1192.  
  1193.        30   {c:\commo\commo.scn}
  1194.  
  1195.           Pathname for initial Screen Image file
  1196.        _________________________________________
  1197.  
  1198.           Information is appended to this file when you use the "Screen
  1199.           Image Save" function or when you write to a disk file in the
  1200.           "Scrollback" function.  See the sections on these functions for
  1201.           details.
  1202.  
  1203.           If a filename only (no path) is specified, the current directory
  1204.           will be used. The pathname of an open Capture File is not
  1205.           allowed.
  1206.  
  1207.        ___________________________________________________
  1208.  
  1209.        31 * {c:\commo\commo.log}    Pathname for Usage Log
  1210.        ___________________________________________________
  1211.  
  1212.           The Usage Log keeps a record of all the calls you make.  If a
  1213.           valid pathname is specified, entries will be made automatically
  1214.           when you connect to a system and when you disconnect (or exit
  1215.           {COMMO}).
  1216.  
  1217.           IMPORTANT!  In order for the log to function properly your modem
  1218.           must be set to provide "true carrier detect" (see Appendix A).
  1219.  
  1220.           Use a null pathname {} to disable the Usage Log.  The Usage Log
  1221.           should be disabled when you are connecting directly to another
  1222.           computer (with a null modem cable).
  1223.  
  1224.           Specify the same log file as your external protocol driver (e.g.,
  1225.           DSZ.LOG or MPT.LOG) and you will have a complete record of your
  1226.           calls, including upload/download statistics.
  1227.  
  1228.           If a filename only (no path) is specified, the current directory
  1229.           will be used.  The pathname of an open Capture File is not
  1230.           allowed.
  1231.  
  1232.  
  1233.  
  1234.                    {COMMO} (tm)  User Guide and Reference           page 20
  1235.  
  1236.  
  1237.        _________________________________________
  1238.  
  1239.        32 * {yes}    Expand blank lines (yes/no)
  1240.        33 * {yes}    Strip linefeeds (yes/no)
  1241.        34   {}       Startup pacing character
  1242.        _________________________________________
  1243.  
  1244.           See "ASCII Upload" for details on these items.
  1245.  
  1246.        __________________________________________________
  1247.  
  1248.        35   {no}    Default to Dialing Directory (yes/no)
  1249.        __________________________________________________
  1250.  
  1251.           If this is set to "yes" the Dialing Directory will be entered
  1252.           when {COMMO} is started.
  1253.  
  1254.        ______________________________________________
  1255.  
  1256.        36   {no}    Start with Local Echo on (yes/no)
  1257.        ______________________________________________
  1258.  
  1259.           If this is set to "yes" Local Echo will be on when {COMMO} is
  1260.           started.  See "Local Echo."
  1261.  
  1262.        _________________________________________________
  1263.  
  1264.        37   {no}    Start with Signal Lights on (yes/no)
  1265.        _________________________________________________
  1266.  
  1267.           If this is set to "yes" Signal Lights will be on when {COMMO} is
  1268.           started.  See "Signal Lights Display."
  1269.  
  1270.        __________________________________________________
  1271.  
  1272.        38   {no}    Start with Capture File open (yes/no)
  1273.        __________________________________________________
  1274.  
  1275.           If this is set to "yes" Capture will be open when {COMMO} is
  1276.           started.  See "Capture File Options."
  1277.  
  1278.        _________________________________________________________
  1279.  
  1280.        39 * {screen}    Startup Capture Mode (screen/filter/raw)
  1281.        _________________________________________________________
  1282.  
  1283.           See "Capture File Options" for a description of each mode.
  1284.  
  1285.  
  1286.  
  1287.                    {COMMO} (tm)  User Guide and Reference           page 21
  1288.  
  1289.  
  1290.        ________________________________________________
  1291.  
  1292.        40 * {no}    Test for enhanced keyboard (yes/no)
  1293.        ________________________________________________
  1294.  
  1295.           Set this to "yes" if your system supports the enhanced (101 key)
  1296.           keyboard.  This will enable you to assign F11, F12 and a number
  1297.           of other keys to your macros.  See "Table of {COMMO} Key-id's".
  1298.  
  1299.        ___________________________________________________________
  1300.  
  1301.        41 * {yes}    Display time of day with System Name (yes/no)
  1302.        ___________________________________________________________
  1303.  
  1304.           If this is "yes" only the first 30 characters of the System Name
  1305.           will be displayed on the Status Line.  The time will be displayed
  1306.           in the remaining space.  If "no" the System Name will be
  1307.           displayed in 40 characters.
  1308.  
  1309.        _________________________________________________
  1310.  
  1311.        42   {yes}    Start with Master Sound on (yes/no)
  1312.        _________________________________________________
  1313.  
  1314.           If this is set to "yes" sound will be on when {COMMO} is started. 
  1315.           See "Sound Control."
  1316.  
  1317.        _______________________________________________
  1318.  
  1319.        43 * {yes}    Dialing connection alarm (yes/no)
  1320.        _______________________________________________
  1321.  
  1322.           Controls the alarm signalling a connection when Auto Dialing is
  1323.           used.
  1324.  
  1325.        __________________________________________________
  1326.  
  1327.        44 * {yes}    ASCII Upload finished alarm (yes/no)
  1328.        __________________________________________________
  1329.  
  1330.           Controls the alarm signalling that an ASCII Upload has completed.
  1331.  
  1332.        _________________________________________________
  1333.  
  1334.        45 * {3}    Maximum number of alarm rings (1-999)
  1335.        _________________________________________________
  1336.  
  1337.           Sets the number of times the alarm will ring.  You may press a
  1338.           key at any time to stop the alarm.
  1339.  
  1340.  
  1341.  
  1342.                    {COMMO} (tm)  User Guide and Reference           page 22
  1343.  
  1344.  
  1345.        _______________________________________________________
  1346.  
  1347.        46   {10}    Scrollback buffer size in kilobytes (0-64)
  1348.        _______________________________________________________
  1349.  
  1350.           The actual minimum size of the buffer (which {COMMO} will
  1351.           compute) depends on the number of screen lines.  For a 25 line
  1352.           screen it will be around 4k bytes -- it will be larger for
  1353.           screens with more lines.  This includes room to save the current
  1354.           screen.
  1355.  
  1356.           Setting the size to 0 disables the Scrollback feature.  See
  1357.           "Scrollback" for details.
  1358.  
  1359.        _____________________________________________________________
  1360.  
  1361.        47 * {no}     Snow checking on CGA adapter (yes/no)
  1362.        48 * {no}     Use BIOS for Terminal Screen scrolling (yes/no)
  1363.        49 * {no}     Use BIOS for Terminal Screen output (yes/no) 
  1364.        _____________________________________________________________
  1365.  
  1366.           Change these video parameters only if necessary.
  1367.  
  1368.           o    Snow checking will slow the display somewhat, but will help
  1369.                to eliminate the "snow" effect on CGA monitors.
  1370.  
  1371.           o    BIOS scrolling enables external scrollback programs to work,
  1372.                but is slower and may cause "flicker" in certain displays.
  1373.  
  1374.           o    The Terminal Screen BIOS display is intended primarily for
  1375.                use with speech synthesizers (enabling blind users to "see"
  1376.                the computer display).  This also slows the display.
  1377.  
  1378.        ____________________________________________________________
  1379.  
  1380.        50   {no}    Auto-detect number of rows and columns (yes/no)
  1381.        ____________________________________________________________
  1382.  
  1383.           {COMMO} will support 25 to 127 rows and 80 to 255 columns on the
  1384.           display, but you MUST set the display into the proper mode before
  1385.           starting the program (EGA/VGA adapters usually come with
  1386.           utilities to set modes such as 50x80, 44x132, etc.).
  1387.  
  1388.           Set this item to "yes" if you want {COMMO} to automatically
  1389.           obtain the current number of rows and columns from the system. 
  1390.           Most systems provide this information.  If the display is
  1391.           unsatisfactory, you may have to set it to "no."
  1392.  
  1393.           Note: The cursor may not display properly in 43 line mode.  This
  1394.           is a problem with some EGA adapters.
  1395.  
  1396.  
  1397.  
  1398.                    {COMMO} (tm)  User Guide and Reference           page 23
  1399.  
  1400.  
  1401.        ______________________________________________________
  1402.  
  1403.        51 * {18}    Number of lines in upper Chat Mode window
  1404.        ______________________________________________________
  1405.  
  1406.           This allows you to adjust the line "split" in Chat Mode.  The
  1407.           minimum number of lines in the upper or lower window is three.
  1408.  
  1409.        _____________________________________________________________
  1410.  
  1411.        52 * {no}    Send when Enter is pressed in Chat Mode (yes/no)
  1412.        _____________________________________________________________
  1413.  
  1414.           If "no" {COMMO} will send each character as you type it.  If
  1415.           "yes" {COMMO} will wait until you press Enter, then send all that
  1416.           you have typed.
  1417.  
  1418.        ____________________________________________
  1419.  
  1420.        53 * {no}    Enable mono attributes (yes/no)
  1421.        ____________________________________________
  1422.  
  1423.           If this is "no" the default mono attributes will be used.  Set it
  1424.           to "yes" if you want to set your own monochrome attributes
  1425.           (colors).  This has no effect on color displays.
  1426.  
  1427.        __________________________________________________
  1428.  
  1429.        54 * {07}               Terminal Screen colors
  1430.        55 * {17}               File window text colors
  1431.        56 * {70}               File window border colors
  1432.        57 * {3f}               File window cursor colors
  1433.        58 * {70}               Small window text colors
  1434.        59 * {17}               Small window border colors
  1435.        60 * {17}               Status Line colors
  1436.        __________________________________________________
  1437.  
  1438.           Press F10 in the Configuration File window to pop up the color
  1439.           chart.  You may use it with color or monochrome displays.
  1440.  
  1441.           Note:  For the most accurate ANSI-BBS or VT102 terminal
  1442.           emulation, the Terminal Screen colors should be set to {07}.  In
  1443.           many cases, {COMMO} uses this color when clearing portions of the
  1444.           screen or when a "reset attributes" sequence is received from the
  1445.           host.
  1446.  
  1447.           "File windows" are full-screen windows such as the Dialing
  1448.           Directory, Macro File, Scrollback Buffer, etc.  "Small windows"
  1449.           are the pop up windows such as Capture File Options or ASCII
  1450.           Upload.
  1451.  
  1452.  
  1453.  
  1454.                    {COMMO} (tm)  User Guide and Reference           page 24
  1455.  
  1456.  
  1457.           Colors should be set so that the different parts of the screen
  1458.           contrast with each other.  For example the Status Line should be
  1459.           easily discernable from the rest of the Terminal Screen.  And the
  1460.           borders and Selector Bar should stand out against the text
  1461.           portion of the various windows.
  1462.  
  1463.  
  1464.        ================================
  1465.        [Alt-H]   How to Use Online Help
  1466.        ================================
  1467.  
  1468.        A summary of {COMMO}'s operations is available by pressing Alt-H. 
  1469.        The Online Help support file, COMMO.HLP, must be in the {COMMO} home
  1470.        directory or you will get an error message, "Unable to open Help
  1471.        file."
  1472.  
  1473.        This message will also be issued if there is not enough memory to
  1474.        load the Online Help file.  Note that the file is retained in memory
  1475.        until {COMMO} requires memory for some other program function.  It
  1476.        will automatically be re-read when necessary. 
  1477.  
  1478.        Once the Help window is entered you will see the Help control keys
  1479.        listed at the bottom of the screen.  At this point you may obtain
  1480.        more detailed information about using Online Help by typing "H".
  1481.  
  1482.  
  1483.        Modifying the Help File
  1484.        =======================
  1485.  
  1486.        When you are familiar with {COMMO} you may wish to reduce the size
  1487.        of the Help File.  Feel free to edit this file with an external
  1488.        editor -- you can even set up your own menu.  The search keys are
  1489.        the bars separating the topics.  The two digit number in the middle
  1490.        of the bar may be changed to create your own key.
  1491.  
  1492.        The HELP macro function enables you to assign a key to go directly
  1493.        to any topic in Online Help.  For example:
  1494.  
  1495.                {cf6} {help 12} {}
  1496.  
  1497.        will go to topic 12 when Ctrl-F6 is pressed.
  1498.  
  1499.        If you change the Help File, remember to keep a backup copy of the
  1500.        original.
  1501.  
  1502.  
  1503.  
  1504.                    {COMMO} (tm)  User Guide and Reference           page 25
  1505.  
  1506.  
  1507.        ===========================
  1508.        [Alt-I]   Screen Image Save
  1509.        ===========================
  1510.  
  1511.        The Screen Image Save is used to append all of the text currently on
  1512.        the screen to a disk file.  This is sometimes handier than
  1513.        repeatedly opening and closing the Capture File.
  1514.  
  1515.        TIPS on using Screen Image Save:
  1516.  
  1517.           The pathname may not be the same as the pathname of an open
  1518.           Capture File.
  1519.  
  1520.           If the file cannot be opened, the old pathname is retained.
  1521.  
  1522.        Note:  The current Screen Image Save file is also used to save
  1523.        blocks of text in the Scrollback feature.
  1524.  
  1525.        See also "Capture File Options" and "Scrollback."
  1526.  
  1527.  
  1528.        ====================
  1529.        [Alt-K]   Scrollback
  1530.        ====================
  1531.  
  1532.        Scrollback allows you to see what was previously on your screen. 
  1533.        Screen data is saved to a memory buffer (the size is defined in the
  1534.        Configuration File).  Set the size to 0 to disable the feature
  1535.        entirely.
  1536.  
  1537.        A number of commands are available in Scrollback:
  1538.  
  1539.        1) You may navigate as in the Online Help file -- scroll up/down,
  1540.           page up/down, beginning/end of buffer, etc.
  1541.  
  1542.        2) Use the String Search feature available in all {COMMO} file
  1543.           windows.
  1544.  
  1545.        3) Change the Screen Image Save pathname.
  1546.  
  1547.        4) Write any part of the Scrollback buffer to the current Screen
  1548.           Image Save file.
  1549.  
  1550.        5) Exit and return to the same place the next time you call
  1551.           Scrollback.
  1552.  
  1553.  
  1554.  
  1555.                    {COMMO} (tm)  User Guide and Reference           page 26
  1556.  
  1557.  
  1558.        =================================
  1559.        [Alt-L]   Set Terminal Parameters
  1560.        =================================
  1561.  
  1562.        Lets you change the current Data Rate, Data Format, Serial Port,
  1563.        Terminal Emulation Type and Inter-Character Delay.
  1564.  
  1565.        Press Alt-L to temporarily change the parameters from the Terminal
  1566.        Screen (these will be set to Configuration File defaults or Dialing
  1567.        Directory overrides when dialing begins).  Observe your changes on
  1568.        the left side of the Status Line.
  1569.  
  1570.        The Terminal Parameters affect the transmission of data to and from
  1571.        your computer.
  1572.  
  1573.  
  1574.        Parameter Descriptions
  1575.        ======================
  1576.  
  1577.           _____
  1578.  
  1579.           Speed
  1580.           _____
  1581.  
  1582.        The rate at which data travels between your computer and the remote
  1583.        system. It is specified as "bits per second" or "bps."  Allowable
  1584.        values are 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600,
  1585.        115200.  These may be abbreviated to the first two characters in
  1586.        Serial Port Parameter strings.
  1587.  
  1588.        See "AutoBaud Detect" for more information on setting the Speed.
  1589.  
  1590.           ___________
  1591.  
  1592.           Data Format
  1593.           ___________
  1594.  
  1595.        This consists of three parts.  Allowable values are:
  1596.  
  1597.           character length:   7, 8
  1598.           parity:             [n]one, [e]ven, [o]dd, [m]ark, [s]pace
  1599.           stop-bits:          1, 2
  1600.  
  1601.        Examples:
  1602.  
  1603.           7o2       7 bit characters, odd parity, 2 stop bits
  1604.           8m1       8 bit characters, mark parity, 1 stop bit
  1605.  
  1606.        The most common formats, "8n1" and "7e1", may be abbreviated to "8"
  1607.        and "7" in parameter strings, such as:
  1608.  
  1609.           {2400,8,1}
  1610.  
  1611.  
  1612.  
  1613.                    {COMMO} (tm)  User Guide and Reference           page 27
  1614.  
  1615.  
  1616.  
  1617.           ___________
  1618.  
  1619.           Serial Port
  1620.           ___________
  1621.  
  1622.        The channel your computer uses to talk to the outside world.  May be
  1623.        1, 2, 3 or 4 (for Com1, Com2, Com3 or Com4).
  1624.  
  1625.           _______________________
  1626.  
  1627.           Terminal Emulation Type
  1628.           _______________________
  1629.  
  1630.        {COMMO} supports the following terminal types:
  1631.  
  1632.           ANSI-BBS (A)   for calling most bulletin board systems
  1633.           VT102    (V)   for calling certain mainframes and online services
  1634.           TTY      (T)   for turning off almost all control functions (lets
  1635.                          you see ANSI control sequences).
  1636.  
  1637.           _____________________
  1638.  
  1639.           Inter-Character Delay
  1640.           _____________________
  1641.  
  1642.        This factor defines the amount of delay to insert between characters
  1643.        transmitted by the SEND macro function and by ASCII Upload.  Use
  1644.        only when the remote is too slow to process the data (drops
  1645.        characters).
  1646.  
  1647.        Each unit is about 5 thousandths of a second (5 ms) on a 4.77 MHz XT
  1648.        class machine.  Faster machines require higher values -- on a 12 MHz
  1649.        AT each unit will only be about 1 ms.
  1650.  
  1651.        For example, to delay 20 ms between characters (50 cps) use a factor
  1652.        of:
  1653.  
  1654.                 4 on 4.77 MHz XT
  1655.                16 on 12 MHz AT
  1656.                27 on 20 MHz 386
  1657.  
  1658.        The factor will also vary when you use multi-tasking software, so
  1659.        adjust as necessary.  The maximum delay allowed is one second.
  1660.  
  1661.  
  1662.  
  1663.                    {COMMO} (tm)  User Guide and Reference           page 28
  1664.  
  1665.  
  1666.        Setting Terminal Parameters
  1667.        ===========================
  1668.  
  1669.           __________________________
  1670.  
  1671.           With the Alt-L Key Command
  1672.           __________________________
  1673.  
  1674.        Alt-L may be used at any time to change parameters temporarily. 
  1675.        Remember that parameters will be reset to the Configuration File
  1676.        defaults whenever dialing begins.
  1677.  
  1678.           _________________________
  1679.  
  1680.           In the Configuration File
  1681.           _________________________
  1682.  
  1683.        Set the default items (Serial Port Parameters, Terminal-Type, Inter-
  1684.        Character Delay) to establish values that will be used at program
  1685.        startup and when dialing begins.
  1686.  
  1687.           ________________________
  1688.  
  1689.           In the Dialing Directory
  1690.           ________________________
  1691.  
  1692.        Serial Port Parameters may be specified in a Dialing Directory entry
  1693.        to override the default settings.  Specify only values that are
  1694.        different.  For example:
  1695.  
  1696.           {,,3}     Different serial port is required for this call
  1697.  
  1698.           {,8o2}    Unusual format
  1699.  
  1700.           ________________________________________________
  1701.  
  1702.           Using the Macro functions PARMs, TERMinal, DELAy
  1703.           ________________________________________________
  1704.  
  1705.        Use these to set parameters during macro execution -- to set a
  1706.        Terminal-Type during a login macro, for example.  See "Programming
  1707.        {COMMO} Macros."
  1708.  
  1709.  
  1710.  
  1711.                    {COMMO} (tm)  User Guide and Reference           page 29
  1712.  
  1713.  
  1714.        =========================
  1715.        [Alt-M]   Macro Processor
  1716.        =========================
  1717.  
  1718.        The Macro Processor executes and maintains {COMMO} macros.  See the
  1719.        section "Programming {COMMO} Macros" which shows you how easily you
  1720.        can automate program operations, link to external protocols (for
  1721.        Uploading/Downloading), assign keys and perform a myriad of other
  1722.        functions.  The Macro File is maintained with the Internal Editor. 
  1723.  
  1724.        See Online Help for details on operations within the Macro Processor
  1725.        window.
  1726.  
  1727.  
  1728.        ==========================================
  1729.        [Alt-O]   Send Modem Initialization String
  1730.        ==========================================
  1731.  
  1732.        Pressing Alt-O at any time from the Terminal Screen will cause the
  1733.        modem initialization string to be sent to the modem.  This is useful
  1734.        if your modem was powered off or if the modem setup was changed.
  1735.  
  1736.  
  1737.        ===============================
  1738.        [Alt-P]   Send Current Password
  1739.        ===============================
  1740.  
  1741.        Each entry in the Dialing Directory can have its own Password
  1742.        String.  After dialing a number, the Alt-P key command will send the
  1743.        current Password String to the remote system.
  1744.  
  1745.        For additional details on Passwords see "Dialing Directory."
  1746.  
  1747.  
  1748.        =============================
  1749.        [Alt-Q]   Quit Call (hang up)
  1750.        =============================
  1751.  
  1752.        Quits the call by dropping DTR.  This will put the modem "on-hook"
  1753.        if response to DTR is enabled (see Appendix A).  If your modem does
  1754.        not respond properly, you may define a macro to send a "hang-up"
  1755.        command.  For modems using the "AT" command set the macro would look
  1756.        like this:
  1757.  
  1758.           {nf0} {send ~~~+++~~~ATH|} {}    Press F10 to hangup
  1759.           
  1760.        Of course, you may assign this macro to any key you like.
  1761.  
  1762.  
  1763.  
  1764.                    {COMMO} (tm)  User Guide and Reference           page 30
  1765.  
  1766.  
  1767.        ======================
  1768.        [Alt-S]   Shell to DOS
  1769.        ======================
  1770.  
  1771.        When you Shell to DOS {COMMO} remains resident in memory and you may
  1772.        perform any DOS functions as you normally do.  Since {COMMO} is
  1773.        small in size, most of your memory is available when you use this
  1774.        key command.
  1775.  
  1776.  
  1777.        ==============================
  1778.        [Alt-U]   Multi Number Dialing
  1779.        ==============================
  1780.  
  1781.        Any number of entries may be "marked" in the Dialing Directory, then
  1782.        automatically dialed in sequence until a connection is established. 
  1783.        Multi Number Dialing may be initiated in one of four ways:
  1784.  
  1785.        1) Bring up the Dialing Directory window with Alt-D, then move the
  1786.           Selector Bar to each desired entry and press [Space] (repeat the
  1787.           procedure to unmark an entry).  Press Alt-U to begin dialing at
  1788.           the location of the Selector Bar.
  1789.  
  1790.        2) Specify entries with Dialing Strings on the command line used to
  1791.           run {COMMO} (see "Command Line Options").  Specified entries will
  1792.           be marked and dialed in sequence when {COMMO} is started.
  1793.  
  1794.        3) Specify entries with Dialing Strings in a macro, using the MARK
  1795.           function (see "Programming {COMMO} Macros").
  1796.  
  1797.        4) Press Alt-U from the Terminal Screen.  Dialing of marked entries
  1798.           will resume with the next system in the sequence.
  1799.  
  1800.        To automatically resume Multi Number Dialing at the end of a Linked
  1801.        Macro, you should use a sequence such as:
  1802.  
  1803.                ... {setlook 60} {lookfor ^jNO CARRIER^m} {dial ,} {}
  1804.  
  1805.        See also "[Alt-D]  Dialing Directory" and the DIAL function under
  1806.        "Programming {COMMO} Macros."
  1807.  
  1808.  
  1809.        ===========================
  1810.        [Alt-X]   Exit from {COMMO}
  1811.        ===========================
  1812.  
  1813.        This key command will cause {COMMO} to terminate.  You may configure
  1814.        {COMMO} to leave DTR high when exiting so that you may exit and
  1815.        remain connected to a system (this is the default, see
  1816.        "Configuration File").  Then if you re-enter {COMMO} you would
  1817.        answer "no" to the question about initializing your modem.
  1818.  
  1819.  
  1820.  
  1821.                    {COMMO} (tm)  User Guide and Reference           page 31
  1822.  
  1823.  
  1824.        Alt-X may also be pressed from the Dialing Directory or Macro File
  1825.        windows for a quick exit.
  1826.  
  1827.  
  1828.        ==============================
  1829.        [Alt-1]   Capture File Options
  1830.        ==============================
  1831.  
  1832.        When Capture is OPEN all information written to your screen will be
  1833.        saved to the designated disk file.  This command allows you to:
  1834.  
  1835.           1)   OPEN/CLOSE the Capture File.
  1836.           2)   Change to a different file.
  1837.           3)   Change the Capture Mode.
  1838.  
  1839.        Data may be captured in one of three modes.  The startup Capture
  1840.        Mode is selected in the Configuration File.
  1841.  
  1842.           If the mode is set to SCREEN, data will be captured exactly as it
  1843.           appears on the Terminal Screen.  This mode greatly improves the
  1844.           appearance of screens drawn with ANSI positioning sequences
  1845.           (animation).
  1846.  
  1847.           FILTER mode is used primarily when you need to capture lines
  1848.           longer than the width of the screen (e.g., to be printed on a
  1849.           wide carriage printer).  ANSI controls will still be stripped out
  1850.           if ANSI-BBS or VT102 emulation is on.
  1851.  
  1852.           Use RAW mode when you want all data captured exactly as it comes
  1853.           from the serial port.  ANSI control sequences will not be
  1854.           stripped and length of lines will be preserved.  This mode can be
  1855.           used to capture ANSI animation and color to be "played back"
  1856.           later.
  1857.  
  1858.        TIPS on using the Capture File:
  1859.  
  1860.           IMPORTANT: When capturing to a floppy drive, the diskette should
  1861.           not be removed until the Capture File is closed (this also
  1862.           applies if the "disk full" message appears).  DOS is unaware of a
  1863.           disk change and may overwrite the replacement disk.
  1864.  
  1865.           The old file will be closed if a new file is opened.
  1866.  
  1867.           If Capture Mode is set to SCREEN, text will be saved as it
  1868.           scrolls OFF the screen.  To prevent loss of data, the entire
  1869.           screen will be saved in the following situations:
  1870.  
  1871.                (1) whenever the screen is cleared
  1872.                (2) Capture is closed with Alt-1
  1873.                (3) {COMMO} is terminated
  1874.                (4) the mode is changed from SCREEN to FILTER or RAW
  1875.  
  1876.  
  1877.  
  1878.                    {COMMO} (tm)  User Guide and Reference           page 32
  1879.  
  1880.  
  1881.           If Capture Mode is set to FILTER or RAW, text will be saved as it
  1882.           arrives from the serial port.
  1883.  
  1884.        See also "Screen Image Save."
  1885.  
  1886.  
  1887.        ==========================
  1888.        [Alt-2]   Print Log Toggle
  1889.        ==========================
  1890.  
  1891.        Turns the Print Log ON/OFF.  When ON all information written to your
  1892.        screen will be printed to LPT1.  Handy for getting hard-copy of file
  1893.        lists, messages, etc.
  1894.  
  1895.        TIPS on using the Print Log:
  1896.  
  1897.           Text is printed as it scrolls OFF the screen.
  1898.  
  1899.           To prevent loss of data, the entire screen will be printed in the
  1900.           following situations:
  1901.  
  1902.                (1) whenever the screen is cleared
  1903.                (2) Print Log is turned off with Alt-2
  1904.                (3) {COMMO} is terminated
  1905.  
  1906.        Flow Control should be used if your printer cannot keep up with the
  1907.        incoming data (see Appendix C).
  1908.  
  1909.  
  1910.        ==============================
  1911.        [Alt-3]   Sound Control Toggle
  1912.        ==============================
  1913.  
  1914.        This is the Master Sound Control toggle.  When sound is OFF all
  1915.        alarms, sounds and beeps will be silenced.  Alarms are individually
  1916.        controlled with items in the Configuration File and with the "%a"
  1917.        parameter in EXECute macro functions.
  1918.  
  1919.  
  1920.        =========================
  1921.        [Alt-4]   AutoBaud Toggle
  1922.        =========================
  1923.  
  1924.        AutoBaud Detect enables {COMMO} to automatically adjust to the line
  1925.        speed of the system you are calling, thus relieving you from having
  1926.        to hang up and call back when you get the wrong speed.
  1927.  
  1928.        TIPS on using AutoBaud:
  1929.  
  1930.           Your modem must be set to return the connection speed responses
  1931.           such as "CONNECT 1200" (see Appendix A "Setting Up Your Modem").
  1932.  
  1933.  
  1934.  
  1935.                    {COMMO} (tm)  User Guide and Reference           page 33
  1936.  
  1937.  
  1938.           The default serial port speed in the Configuration File should be
  1939.           set to your modem's highest speed.
  1940.  
  1941.           ____________________
  1942.  
  1943.           Most 2400 bps modems
  1944.           ____________________
  1945.  
  1946.        Toggle AutoBaud Detect to the ON state (uppercase "B" on the Status
  1947.        Line). Set the default speed in the Configuration File to 2400.  The
  1948.        following result-codes will cause the indicated actions:
  1949.  
  1950.           CONNECT 2400  -->  serial port remains at 2400 bps
  1951.           CONNECT 1200  -->  serial port adjusted to 1200 bps
  1952.           CONNECT       -->  serial port adjusted to 300 bps
  1953.  
  1954.           _________________
  1955.  
  1956.           High-speed modems
  1957.           _________________
  1958.  
  1959.  
  1960.        Most high-speed modems require that the serial port be "locked" at
  1961.        19200 bps or 38400 bps.  The modem will then automatically adjust to
  1962.        the line (modem-to-modem) speed.  In this case AutoBaud must be
  1963.        turned OFF to prevent {COMMO} from changing the serial port speed.
  1964.  
  1965.        Some of these modems may also be operated such that the serial port
  1966.        must be adjusted to the speed given in the CONNECT message.  In this
  1967.        case follow the instructions for 2400 bps modems above.
  1968.  
  1969.  
  1970.        ===========================
  1971.        [Alt-5]   Local Echo Toggle
  1972.        ===========================
  1973.  
  1974.        Local Echo (sometimes called half-duplex) is normally used when you
  1975.        connect to a host that does not echo what you type.  {COMMO} will
  1976.        assume that the host is sending a linefeed with each carriage
  1977.        return.
  1978.  
  1979.        Typed characters will be displayed directly to the screen.
  1980.  
  1981.  
  1982.        ==============================
  1983.        [Alt-0]   Signal Lights Toggle
  1984.        ==============================
  1985.  
  1986.        Turns ON/OFF the "modem lights" display on the status line.  Shows
  1987.        the state of the RS-232C signals, including send/receive.
  1988.  
  1989.  
  1990.  
  1991.                    {COMMO} (tm)  User Guide and Reference           page 34
  1992.  
  1993.  
  1994.        This toggles the right half of the Status Line from the System Name
  1995.        to the Signal Lights Display.  See "What is on the Status Line" in
  1996.        Online Help for a complete description of the Status Line
  1997.        indicators.
  1998.  
  1999.  
  2000.        ==========================
  2001.        [Alt--]   Chat Mode Toggle  (Alt minus)
  2002.        ==========================
  2003.  
  2004.        Chat Mode is normally used when you wish to converse via keyboard.
  2005.        The screen will be split with the upper portion showing what the
  2006.        remote is sending, while the lower portion shows what you type.
  2007.  
  2008.        The method used to send typed characters is set in the Configuration
  2009.        File under the section "Video and Chat Mode."  The two possible
  2010.        methods are:
  2011.  
  2012.           1)   Each character is sent as you type it.  This method is
  2013.                normally used when you are chatting with another person who
  2014.                is also in Chat Mode.
  2015.  
  2016.           2)   All characters are sent at once when you press Enter (up to
  2017.                240 characters will be buffered).  Use this method when you
  2018.                are using a teleconferencing system or "CB Simulator."
  2019.  
  2020.        The number of lines in the upper and lower portions of the screen
  2021.        (the "line split") may also be set in the "Video and Chat Mode"
  2022.        section.
  2023.  
  2024.        TIPS on using Chat Mode:
  2025.  
  2026.           Alt-- (Alt minus) is used to enter AND exit Chat Mode.
  2027.  
  2028.           All {COMMO} functions are available in Chat Mode except Doorway
  2029.           Mode.
  2030.  
  2031.  
  2032.        =============================
  2033.        [Alt-=]   Doorway Mode Toggle
  2034.        =============================
  2035.  
  2036.        Definition: "Extended keys" are function keys, Alt keys, cursor
  2037.        keys, etc.  In other words, keys that do not generate ASCII
  2038.        characters.
  2039.  
  2040.        In Doorway Mode all extended keys will send their key codes to the
  2041.        remote (instead of activating {COMMO} functions).  Thus Doorway Mode
  2042.        can be used to operate most application software on the remote
  2043.        system when used with a host program such as Marshall Dudley's
  2044.        Doorway.  In addition some BBS full-screen editors use Doorway Mode.
  2045.  
  2046.  
  2047.  
  2048.                    {COMMO} (tm)  User Guide and Reference           page 35
  2049.  
  2050.  
  2051.        TIPS on using Doorway Mode:
  2052.  
  2053.           The Alt-= key is necessarily reserved for exiting Doorway Mode
  2054.           and thus cannot be sent to the remote.  Be sure to configure
  2055.           remote applications accordingly.
  2056.  
  2057.           The display should be set to the number of lines expected by the
  2058.           host program.  Usually this is 25 lines of text.  If your display
  2059.           is not in the proper mode, the results will be unpredictable.
  2060.  
  2061.           The Status Line is normally suppressed in Doorway Mode, but may
  2062.           be turned on by using the "s" parameter in a macro:
  2063.  
  2064.                {al=} {doorway s} {}
  2065.  
  2066.           The "s" parameter is ignored when exiting Doorway Mode and the
  2067.           Status Line will be restored to its previous state.  Remember
  2068.           that when the Status Line is on, there is one less usable line on
  2069.           the Terminal Screen.
  2070.  
  2071.           If it is necessary to clear the screen or to reset the terminal
  2072.           mode parameters when starting Doorway Mode, use a macro.  For
  2073.           example:
  2074.  
  2075.                {al=} {clear} {term a} {doorway} {}
  2076.  
  2077.           This macro will execute when entering or exiting Doorway Mode
  2078.           (Alt-= must be used to exit, but any key may be assigned to enter
  2079.           Doorway Mode).
  2080.  
  2081.           For most applications you will want Terminal-Type set to
  2082.           ANSI-BBS.  It's a good idea to enter Doorway Mode before starting
  2083.           the host program.  The host may send commands to initialize the
  2084.           terminal.
  2085.  
  2086.           If Software Flow Control is enabled, the ASCII character values
  2087.           17 and 19 (XON and XOFF) will not display.  If these characters
  2088.           are needed, Software Flow Control must be turned off.
  2089.  
  2090.  
  2091.        =======================
  2092.        Uploading / Downloading
  2093.        =======================
  2094.  
  2095.        ASCII Upload is the only file transfer protocol internal to {COMMO}.
  2096.        The Macro Processor enables you to execute external protocol
  2097.        "driver" programs with ease and rapidity.
  2098.  
  2099.        The Macro File is pre-configured with macros that execute various
  2100.        popular protocol drivers, including DSZ.COM which performs Xmodem,
  2101.        Ymodem and Zmodem uploads and downloads.  Use the Alt-M key command
  2102.        to select one of these macros.  You may add macros for any other
  2103.  
  2104.  
  2105.  
  2106.                    {COMMO} (tm)  User Guide and Reference           page 36
  2107.  
  2108.  
  2109.        protocol drivers that you need.  See "Programming {COMMO} Macros"
  2110.        for details on writing macros.
  2111.  
  2112.  
  2113.        Installing DSZ.COM
  2114.        ==================
  2115.  
  2116.        DSZ is a Shareware program from Omen Technology and is highly
  2117.        recommended for fast and reliable file transfers.  Like {COMMO} it
  2118.        must be registered for continued use.  DSZ may almost always be
  2119.        obtained from the source where you obtained {COMMO} and is usually
  2120.        archived as DSZmmdd.ZIP (mmdd is a release date).
  2121.  
  2122.        To install DSZ just place DSZ.COM in a directory which is specified
  2123.        in your DOS path statement.  If you don't have a path statement in
  2124.        your AUTOEXEC.BAT file, place DSZ.COM in your C:\COMMO directory. 
  2125.        Be sure to change to this directory before you start {COMMO}.
  2126.  
  2127.        MPT.EXE may be installed in a similar fashion for doing MPt (Puma)
  2128.        transfers.
  2129.  
  2130.  
  2131.        {COMMO} Auto Receive
  2132.        ====================
  2133.  
  2134.        This feature will automatically start a macro when a specified
  2135.        string is received from the serial port and is normally used for
  2136.        starting downloads.
  2137.  
  2138.        Up to four strings and respective macro-id's may be defined in the
  2139.        "Terminal and Modem" section of the Configuration File.  These are
  2140.        preconfigured for the Zmodem and MPt protocol "signature" strings,
  2141.        but you may change them or add new ones as desired.
  2142.  
  2143.        Once you have installed the DSZ.COM or MPT.EXE programs (see above)
  2144.        you must change the macro-id's in the Macro File.  These are
  2145.        initialized to {zzz} and {mmm} to prevent {COMMO} from trying to
  2146.        execute programs that aren't there.  Just press Alt-M and change:
  2147.  
  2148.                {zzz}  to  {.z.}  for Zmodem AutoDownload
  2149.                {mmm}  to  {.m.}  for MPt (Puma) Auto-Start
  2150.  
  2151.        Don't change them until you have installed the respective programs.
  2152.        {COMMO} will execute the macro as soon as the signature string is
  2153.        received (be patient, a BBS may take several seconds to load and
  2154.        execute the protocol program).
  2155.  
  2156.        If you have not properly installed the protocol program, the message
  2157.        "Bad command or file name" will be periodically displayed by DOS. 
  2158.        If this happens type Ctrl-X several times to abort the sender and
  2159.        cancel the transfer.
  2160.  
  2161.  
  2162.  
  2163.                    {COMMO} (tm)  User Guide and Reference           page 37
  2164.  
  2165.  
  2166.        TIPS on using Auto Receive:
  2167.  
  2168.           Auto Receive will not trigger when any macro is running.  It may
  2169.           trigger when the macro stops, but keep in mind that characters
  2170.           displayed during macro functions are not buffered.  Most
  2171.           functions do not display characters; this includes SEND.
  2172.  
  2173.           The serial port input buffer will be cleared following any EXEC,
  2174.           EXEN or EXED that is part of an Auto Receive macro.  This
  2175.           prevents repeated signature strings from triggering the macro
  2176.           more than once.
  2177.  
  2178.           If you need to download within a macro, you should do a LOOKfor
  2179.           to wait for the signature string, then CALL the download macro
  2180.           (make sure you have a RETUrn at the end).
  2181.  
  2182.           Using short strings, such as "^E" for CIS B protocol may result
  2183.           in unexpected triggering of the macro.  This is because other
  2184.           systems may send the same string for a different purpose (to
  2185.           display a "club" symbol, for example).  Thus it may be necessary
  2186.           to disable a string at times or to discontinue its use.
  2187.  
  2188.           A string may be disabled by removing the corresponding macro-id
  2189.           in the Macro File, but this degrades performance since the Macro
  2190.           File must be scanned each time a "hit" occurs.  Instead the
  2191.           Configuration File item should be replaced with a null {}.
  2192.  
  2193.           An Auto Receive string can be used to automatically continue
  2194.           Multi Number Dialing after you disconnect (in manual mode).  Set
  2195.           one of the strings to:
  2196.  
  2197.                     {ncd,^jNO CARRIER^m}
  2198.  
  2199.           Then enter a macro in the Macro File:
  2200.  
  2201.                     {ncd} {dial ,} {}
  2202.  
  2203.           When your modem sends "NO CARRIER" the macro will start and Multi
  2204.           Number Dialing will resume if any more systems are marked in the
  2205.           Dialing Directory.
  2206.  
  2207.        See also "TIPS on creating LOOKfor strings" in the section
  2208.        describing the LOOKfor function.
  2209.  
  2210.  
  2211.  
  2212.                    {COMMO} (tm)  User Guide and Reference           page 38
  2213.  
  2214.  
  2215.        ==========================
  2216.        Programming {COMMO} Macros
  2217.        ==========================
  2218.  
  2219.        IMPORTANT:  Please read the next few pages before you attempt to
  2220.        write any macros!  The rules for writing {COMMO} macros are few in
  2221.        number, but must be followed carefully.  Examples of more complex
  2222.        macro programming are given in the sample Macro File, COMMO.MAC, and
  2223.        in the supplied file, MACROS.TXT.
  2224.  
  2225.        The following sections assume familiarity with {COMMO}'s key
  2226.        commands and with other features of the program.  Since many macro
  2227.        functions have corresponding key commands, duplicate explanations
  2228.        will not be given here.  Refer to the description of the key command
  2229.        in a previous section.
  2230.  
  2231.        {COMMO} macros may be used to perform many different operations, yet
  2232.        their structure is simple and consistent.  Here are some examples:
  2233.  
  2234.           {alk} {clear} {stop}
  2235.  
  2236.        This macro will define Alt-K to clear the screen.  "alk" is called a
  2237.        "macro identifier" or "macro-id" for short, and is three characters
  2238.        in length.
  2239.  
  2240.        Certain macro-id's are reserved to represent keys on the keyboard,
  2241.        such as "alk" in this case, and are called "key-id's."
  2242.  
  2243.        CLEAr is called a "function" and is represented by four or more
  2244.        characters of which only the first four are necessary.
  2245.  
  2246.        The STOP function is used here to terminate the macro and may be
  2247.        used in either it's long or short form:
  2248.  
  2249.           ... {stop}          long form
  2250.           ... {}              short form
  2251.  
  2252.        Note that the default key to clear the screen, Alt-C, is still in
  2253.        effect unless it is reassigned.
  2254.  
  2255.        All of {COMMO} key-id's and functions are described in later
  2256.        sections.  They are also summarized in Online Help.
  2257.  
  2258.           {abc}     {setlook 30,hng,3,|} {lookfor first name?}
  2259.                     {send Fred|} {return}
  2260.  
  2261.        In this macro the SETLook function will set timeout parameters for
  2262.        subsequent LOOKfor functions.  The LOOKfor will then watch the data
  2263.        coming in from the modem and when it sees "first name?", control
  2264.        will pass to the next function.  In this case the next function,
  2265.        SEND, will send the string "Fred" followed by a carriage return
  2266.        (indicated by the "|").
  2267.  
  2268.  
  2269.  
  2270.                    {COMMO} (tm)  User Guide and Reference           page 39
  2271.  
  2272.  
  2273.  
  2274.        The macro ends with a RETUrn function.  If the macro was CALLed from
  2275.        another macro, control will return to the CALLing macro.  Otherwise
  2276.        the RETUrn will behave like a STOP.
  2277.  
  2278.           {bbs}     {capture y,commo.cap} {call abc}
  2279.                     {asciiup textfile.xyz,:} {}
  2280.  
  2281.        This macro will open the capture file "commo.cap" (the "y" means
  2282.        "yes", open the file).  Then it will execute the previously
  2283.        described macro "abc."  Then it will ASCII Upload the file
  2284.        "textfile.xyz" using the pacing character ":".
  2285.  
  2286.        Note that macros may occupy more than one line in the Macro File.
  2287.  
  2288.  
  2289.        Macro-id and Function Summary
  2290.        =============================
  2291.  
  2292.        MACRO-ID's must be three characters (commas and curly braces should
  2293.        not be used).  Case is ignored so that "GK1" is the same as "gk1" or
  2294.        "gK1."
  2295.  
  2296.        Macro-id's should be unique within each Macro File.  {COMMO} will
  2297.        always use the first occurrence of a duplicated macro-id.
  2298.  
  2299.        Macro-id's may appear anywhere within macros and may be the targets
  2300.        of CALL, GOTO and other functions.  Multiple macro-id's may appear
  2301.        before any function:
  2302.  
  2303.           {aln} {aly} {dial 50,abc} {}.
  2304.  
  2305.  
  2306.        FUNCTION NAMES are four or more characters and may always be
  2307.        abbreviated to the first four.  Case is ignored here as well.
  2308.  
  2309.        Remember to terminate each macro with a STOP function unless it
  2310.        already ends with a function which does not return control in line,
  2311.        such as GOTO, RETUrn, EXIT, etc.  If you don't, processing will
  2312.        continue with the next macro in your Macro File!
  2313.  
  2314.  
  2315.        Additional Macro File Rules
  2316.        ===========================
  2317.  
  2318.        The Macro File is entirely free-form.  Macro-id's and functions may
  2319.        appear on the same line or on separate lines.  More that one
  2320.        macro-id may appear on the same line:
  2321.  
  2322.           {ala} {clear} {}    {alw} {sound n} {}
  2323.  
  2324.  
  2325.  
  2326.                    {COMMO} (tm)  User Guide and Reference           page 40
  2327.  
  2328.  
  2329.        Note that only the first may be executed from the Macro File window
  2330.        using the Selector Bar.  Comments may appear anywhere outside the
  2331.        curly braces.
  2332.  
  2333.  
  2334.        Executing Macros
  2335.        ================
  2336.  
  2337.        Macro execution may be started in a number of ways:
  2338.  
  2339.        1) Open the Macro Processor window (Alt-M), position the Selector
  2340.           Bar on the macro-id and press [Enter] (the macro-id must be in
  2341.           the first set of curly braces on the line).
  2342.  
  2343.        2) If the macro-id is also a key-id, then you may press that key
  2344.           from the Terminal Screen.  If the same key-id appears more than
  2345.           once, the first occurrence will be used.
  2346.  
  2347.        3) The macro may be linked to a Dialing Directory entry.  In this
  2348.           case {COMMO} will GOTO the macro when a connection is established
  2349.           with that system.
  2350.  
  2351.        4) The macro may be specified on the command line with the switch
  2352.           "/m=".  It will be started as soon as {COMMO} has initialized
  2353.           itself.
  2354.  
  2355.        5) The macro may be an argument of another function such as CALL,
  2356.           GOTO, DIAL or SETLook (these are detailed in a later section).
  2357.  
  2358.  
  2359.        Additional Macro Execution Rules
  2360.        ================================
  2361.  
  2362.        Use [Ctrl-Enter] instead of [Enter] to start a macro and {COMMO}
  2363.        will wait after preparing EXECute functions (before they are
  2364.        executed by DOS).  {COMMO} will also wait before returning to the
  2365.        Terminal Screen so that you may see any error messages from the
  2366.        executing program.
  2367.  
  2368.        ASCII keys may be typed to the serial port during LOOKfor, PAUSe and
  2369.        HOLD functions.
  2370.  
  2371.        The [Esc] key is used to terminate macro processing.  To send an Esc
  2372.        code to the remote (ASCII 27) during macro execution, press Ctrl-[
  2373.        (Ctrl + left bracket).
  2374.  
  2375.        The Macro Processor will execute functions in order until one of the
  2376.        following conditions occur:
  2377.  
  2378.        1) A CALL, GOTO, RETURn, STOP, EXIT, etc. is encountered.
  2379.  
  2380.  
  2381.  
  2382.                    {COMMO} (tm)  User Guide and Reference           page 41
  2383.  
  2384.  
  2385.        2) Control is transferred to an alternate macro from certain
  2386.           functions when a special condition occurs.  An example of this is
  2387.           the SETLook function.  The alternate will execute when a
  2388.           subsequent LOOKfor times out.
  2389.  
  2390.        3) A macro error occurs.  This will bring up the Macro Error window,
  2391.           indicating the location of the problem.  The macro is terminated.
  2392.  
  2393.        4) [Esc] is pressed.  Macro processing is terminated.
  2394.  
  2395.        5) The end of the Macro File is reached.
  2396.  
  2397.  
  2398.        Current function execution may be terminated by pressing
  2399.        [Ctrl-Break].  For example, this can be used to terminate a LOOKfor,
  2400.        PAUSe or HOLD prematurely.  The macro will advance to the next
  2401.        function.
  2402.  
  2403.        Some macro functions show their current action on the status line at
  2404.        the bottom of the screen.  In addition, a "face" character in the
  2405.        middle of the status line indicates that a macro is executing.
  2406.  
  2407.  
  2408.        =======================
  2409.        {COMMO} Macro Functions
  2410.        =======================
  2411.  
  2412.        The purpose of this section is to show the syntax of each function
  2413.        and the meaning of its arguments through examples.  All functions
  2414.        are listed here, but details on functions which are also default key
  2415.        commands are found in the section "{COMMO} Key Commands."
  2416.  
  2417.        Function names are shown with their four-letter abbreviations in
  2418.        uppercase.  The following conventions are used in many functions:
  2419.  
  2420.           "y" or "yes" is used to indicate "yes", "on",  "open",  etc.
  2421.           "n" or "no"  is used to indicate "no",  "off", "close", etc.
  2422.  
  2423.        This provides a highly consistent macro structure which is very easy
  2424.        to remember.
  2425.  
  2426.  
  2427.        Function Arguments
  2428.        ==================
  2429.  
  2430.        Arguments are the parameters that follow the function name.  One
  2431.        space separates the function name from the arguments (extra spaces
  2432.        must be avoided).  Multiple arguments are separated by commas.  
  2433.         
  2434.  
  2435.  
  2436.  
  2437.                    {COMMO} (tm)  User Guide and Reference           page 42
  2438.  
  2439.  
  2440.           {bbs}     {capture y,commo.cap} {call abc}
  2441.                     {asciiup textfile.xyz,:} {return}
  2442.  
  2443.        Here the function CAPTure has two arguments: "y" and "commo.cap."
  2444.  
  2445.           {abc} {lookfor first name?} {send Fred|} {}
  2446.  
  2447.        The function LOOKfor has one argument: "first name?".  Quotation
  2448.        marks are NOT used to enclose data strings or filenames in {COMMO}
  2449.        macros.
  2450.  
  2451.        When a function is also associated with a default key command, the
  2452.        lack of arguments will cause the function to behave like the key
  2453.        command -- usually bringing up a window or toggling a toggle.  This
  2454.        is useful for reassigning keys.
  2455.  
  2456.  
  2457.        =======================================
  2458.        Description of Functions (alphabetical)
  2459.        =======================================
  2460.  
  2461.  
  2462.        ALARm
  2463.        -----
  2464.        Default key: none
  2465.        Description: Ring the alarm.
  2466.  
  2467.        Examples:
  2468.  
  2469.           {alarm}             Ring alarm, ring count in Config. File.
  2470.           {alarm 2}           Ring alarm 2 times.
  2471.  
  2472.        {COMMO} will wait until the alarm has stopped ringing before
  2473.        proceeding to the next macro function (the alarm may be terminated
  2474.        early by pressing a key).
  2475.  
  2476.  
  2477.        ASCIiup
  2478.        -------
  2479.        Default key: Alt-A
  2480.        Description: Upload an ASCII (text) file.
  2481.  
  2482.        General form:
  2483.  
  2484.           {ASCIiup pathname,pace}
  2485.  
  2486.                pathname       The complete path and filename (if the path
  2487.                               is absent, the current directory will be
  2488.                               used). 
  2489.  
  2490.                pace           The pacing character to be used.
  2491.  
  2492.  
  2493.  
  2494.                    {COMMO} (tm)  User Guide and Reference           page 43
  2495.  
  2496.  
  2497.        Examples:    
  2498.  
  2499.           {asci}                        Open ASCII Upload window.
  2500.  
  2501.           {asci c:\msgs\file.xyz,:}     Upload "file.xyz."  Use ":" for
  2502.                                         pacing.
  2503.  
  2504.           {asci c:\msgs\file.xyz}       Same, but use current pacing
  2505.                                         character.
  2506.  
  2507.           {asci c:\msgs\file.xyz,}      Same, but no pacing.
  2508.  
  2509.           {asci ,?}                     Set current pacing character to "?"
  2510.  
  2511.           {asci ,}                      Set current pacing to "no" pacing.
  2512.  
  2513.        The pacing character may be entered according to the rules in
  2514.        Appendix D "ASCII Character Representation."  For example, "^m" or
  2515.        "|" may be used to represent the carriage return.
  2516.  
  2517.  
  2518.        AUTObaud
  2519.        --------
  2520.        Default key: Alt-5
  2521.        Description: Set AutoBaud toggle.
  2522.  
  2523.        Examples:
  2524.  
  2525.           {auto}              Toggle AutoBaud on/off
  2526.           {auto y}            Turn on AutoBaud     
  2527.           {auto n}            Turn off AutoBaud
  2528.  
  2529.  
  2530.        BEEP
  2531.        ----
  2532.        Default key: none
  2533.        Description: Sound a beep.
  2534.  
  2535.        Example:
  2536.  
  2537.           {beep}              No arguments.
  2538.  
  2539.  
  2540.        BREAk
  2541.        -----
  2542.        Default key: Alt-B
  2543.        Description: Send a break.
  2544.  
  2545.        Example:
  2546.  
  2547.           {break}             No arguments.
  2548.  
  2549.  
  2550.  
  2551.                    {COMMO} (tm)  User Guide and Reference           page 44
  2552.  
  2553.  
  2554.  
  2555.        CALL
  2556.        ----
  2557.        Default key: none
  2558.        Description: Execute another macro.
  2559.  
  2560.        Example:
  2561.  
  2562.           {call abc}          Execute macro abc.
  2563.  
  2564.        If the macro "abc" executes a RETUrn function, then control returns
  2565.        to the function following the CALL.
  2566.  
  2567.        Note that macros may be nested up to 32 deep.
  2568.  
  2569.        See also RETUrn, PUSHstack, POPStack.
  2570.  
  2571.  
  2572.        CAPMode
  2573.        -------
  2574.        Default key: none
  2575.        Description: Set Capture Mode.
  2576.  
  2577.        Examples:
  2578.  
  2579.           {capmode screen}         Set Capture Mode to SCREEN.
  2580.           {capmode filter}         Set Capture Mode to FILTER.
  2581.           {capmode raw}            Set Capture Mode to RAW.
  2582.  
  2583.  
  2584.        CAPTure
  2585.        -------
  2586.        Default key: Alt-1
  2587.        Description: Capture File Options.
  2588.  
  2589.        Examples:
  2590.  
  2591.           {capture}                     Open Capture File Options window.
  2592.  
  2593.           {capture y}                   Open current Capture File.
  2594.  
  2595.           {capture n}                   Close current Capture File.
  2596.  
  2597.           {capt y,c:\commo\file.xyz}    Open indicated Capture File.
  2598.  
  2599.           {capt n,c:\dl\newfile.cap}    Close current Capture File, set new
  2600.                                         file as indicated.
  2601.  
  2602.        Note:  The current Capture File will always be closed when a new
  2603.        file is opened.
  2604.  
  2605.        See also CAPMode.
  2606.  
  2607.  
  2608.  
  2609.                    {COMMO} (tm)  User Guide and Reference           page 45
  2610.  
  2611.  
  2612.  
  2613.  
  2614.        CHATmode
  2615.        --------
  2616.        Default key: Alt-- (Alt minus)
  2617.        Description: Set Chat Mode toggle.
  2618.  
  2619.        Examples:
  2620.  
  2621.           {chat}              Toggle Chat Mode on/off.
  2622.           {chat y}            Turn on Chat Mode.
  2623.           {chat n}            Turn off Chat Mode.
  2624.  
  2625.  
  2626.        CLEAr
  2627.        -----
  2628.        Default key: Alt-C
  2629.        Description: Clear Terminal Screen to default colors.
  2630.  
  2631.        Example:
  2632.  
  2633.           {clear}             No arguments.
  2634.  
  2635.  
  2636.        CONFig
  2637.        ------
  2638.        Default key: Alt-G
  2639.        Description: Edit Configuration File.
  2640.  
  2641.        Example:
  2642.  
  2643.           {config}            No arguments.
  2644.  
  2645.  
  2646.        CURSor
  2647.        ------
  2648.        Default key: none
  2649.        Description: Terminal Screen cursor on/off.
  2650.  
  2651.        Examples:
  2652.  
  2653.           {cursor}            Toggle Terminal cursor on/off.
  2654.           {curs y}            Turn on Terminal Screen cursor.
  2655.           {curs n}            Turn off Terminal Screen cursor.
  2656.  
  2657.  
  2658.        DELAy
  2659.        -----
  2660.        Default key: none
  2661.        Description: Set Inter-Character Delay factor.
  2662.  
  2663.        Example:
  2664.  
  2665.  
  2666.  
  2667.                    {COMMO} (tm)  User Guide and Reference           page 46
  2668.  
  2669.  
  2670.  
  2671.           {delay 25}          Set factor to 25.
  2672.  
  2673.  
  2674.        DIAL
  2675.        ----
  2676.        Default keys: Alt-D, Alt-U
  2677.        Description: Dialing Directory.
  2678.  
  2679.        Examples:
  2680.  
  2681.           {dial}              Open Dialing Directory window (like Alt-D).
  2682.  
  2683.           {dial ,}            Multi Number Dial (like Alt-U).
  2684.  
  2685.           {dial 25,abc}       Multi Number dial with try count.
  2686.  
  2687.        25      is the maximum number of dialing tries.  If no connection is
  2688.                established when the try count is exhausted, the macro in
  2689.                the second argument will be started.  May be 0 to 999.  "0"
  2690.                means unlimited.  
  2691.  
  2692.        abc     is a macro to GOTO if the try count in the first argument is
  2693.                exhausted.  If no macro is specified or if the macro-id is
  2694.                invalid, control will pass to the next function.
  2695.  
  2696.        Default arguments are:      Dialing tries       0 (unlimited)
  2697.                                    Macro               none
  2698.  
  2699.        Null arguments in the DIAL function will revert to these defaults.
  2700.  
  2701.  
  2702.        Marked numbers will be redialed in sequence.  Numbers may be marked
  2703.        in one of several ways:
  2704.  
  2705.           1)   Manually in the Dialing Directory window.
  2706.           2)   By placing Dialing Strings on the {COMMO} command line.
  2707.           3)   Using the MARK macro function.
  2708.  
  2709.        If a connection occurs and a valid Linked Macro is specified in the
  2710.        Dialing Directory, the macro will be started (as a GOTO).  If no
  2711.        macro is specified in the Dialing Directory, control is passed to
  2712.        the next function.
  2713.  
  2714.        To automatically resume Multi Number Dialing at the end of a Linked
  2715.        Macro, you should use a sequence such as:
  2716.  
  2717.                ... {setlook 60} {lookfor ^jNO CARRIER^m} {dial ,} {}
  2718.  
  2719.        This allows more than one system to be called without operator
  2720.        intervention.
  2721.  
  2722.  
  2723.  
  2724.                    {COMMO} (tm)  User Guide and Reference           page 47
  2725.  
  2726.  
  2727.        See also: MARK, UNMArk.
  2728.  
  2729.  
  2730.        DISPlay
  2731.        -------
  2732.        Default key: none
  2733.        Description: Display a string to the screen.
  2734.  
  2735.        General form:
  2736.  
  2737.           {DISPlay row,col,attr,string}
  2738.  
  2739.                row       The row where the string will display.
  2740.                col       The column where the string will display.
  2741.                attr      The attribute (colors) of the string.
  2742.                string    The text of the string (no quotes).
  2743.  
  2744.        Examples:
  2745.  
  2746.           {display 12,20,17,Hello!}     Display "Hello!" at row 12, column
  2747.                                         20.  Colors are white on blue.
  2748.  
  2749.           {disp ,,,Hello, again.^m^j}   Display "Hello, again." at the
  2750.                                         current cursor using the current
  2751.                                         attribute, followed by a cr/lf.
  2752.  
  2753.           {disp 3,40}                   Position the cursor at row 3,
  2754.                                         column 40.
  2755.  
  2756.        The attribute is specified in the same manner as the colors in the
  2757.        Configuration File (press F10 in the Internal Editor to display the
  2758.        Color Chart).
  2759.  
  2760.        Setting background colors to high intensity values will cause
  2761.        blinking (for example, using "9" instead of "1" will still give a
  2762.        blue background but the foreground character will blink).  
  2763.  
  2764.        After the string is displayed, the previous Terminal Screen
  2765.        attribute will be restored.
  2766.  
  2767.  
  2768.        DOORway
  2769.        -------
  2770.        Default key: Alt-=
  2771.        Description: Toggle Doorway Mode.
  2772.  
  2773.        Example:
  2774.  
  2775.           {doorway}           Toggle Doorway Mode on/off.
  2776.           {door s}            Status Line on when entering Doorway Mode.
  2777.  
  2778.  
  2779.  
  2780.                    {COMMO} (tm)  User Guide and Reference           page 48
  2781.  
  2782.  
  2783.        The "s" parameter is ignored when exiting Doorway Mode (the Status
  2784.        Line will be restored to its prior state).
  2785.  
  2786.  
  2787.        EXECute
  2788.        -------
  2789.        Default key: none
  2790.        Description: Execute a DOS command.
  2791.  
  2792.        This function enables you to "build" a command to be executed by
  2793.        DOS.  The DOS command processor (COMMAND.COM) is used, which implies
  2794.        that you may specify any command as you would type it from the DOS
  2795.        prompt.  Thus you can execute batch files and internal DOS commands
  2796.        (REN, DEL, etc.).  Also you can omit command paths and extensions
  2797.        (if the command is in your PATH).
  2798.  
  2799.        A number of special parameters are available which will either
  2800.        substitute the current value of a variable or perform a specific
  2801.        action before or after command execution.
  2802.  
  2803.        In addition, the user input parameter "%i" lets you enter
  2804.        information that is not known until execution time.  For example you
  2805.        can insert a filename (or pathname) at a certain point in the
  2806.        command.
  2807.  
  2808.        The special parameters are detailed here and are also summarized in
  2809.        Online Help.  They are also used in the EXED and EXEN functions.
  2810.  
  2811.           %i   General user input prompt.  May be used more than once in a
  2812.                command and will result in a prompt for input in the
  2813.                "Execute a DOS Command" window.
  2814.  
  2815.           %p   Current serial port number (1,2,3 or 4).
  2816.  
  2817.           %s   Current serial port speed (2400, 38400, etc.).
  2818.  
  2819.           %m   Current modem speed obtained from the connect message.  For
  2820.                example, "CONNECT 2400" sets %m to "2400".  This is used to
  2821.                pass the modem speed to external protocols (for time
  2822.                estimation) when the serial port is "locked" at a higher
  2823.                speed.
  2824.  
  2825.                If your modem provides a "CARRIER" message containing the
  2826.                modem speed, then set the Dialing Success Response in the
  2827.                Configuration File to "CARRIER" instead of "CONNECT". 
  2828.  
  2829.                Note that this value is "null" when no speed is returned in
  2830.                the connect message.
  2831.  
  2832.           %u   Current upload directory (from Config File).
  2833.  
  2834.           %d   Current download directory (from Config File).
  2835.  
  2836.  
  2837.  
  2838.                    {COMMO} (tm)  User Guide and Reference           page 49
  2839.  
  2840.  
  2841.  
  2842.           %c   Current capture file (use Alt-1 to check).
  2843.  
  2844.           %k   Insert an ASCII control character into the DOS command.  For
  2845.                example to issue a formfeed to your printer you could have
  2846.                the macro function: {exec echo %k^L > prn}.  See Appendix D
  2847.                for rules on representing control characters.
  2848.  
  2849.           %a   Sound the alarm at the end of command execution.
  2850.  
  2851.           %w   Wait (pause) before restoring the Terminal Screen.  This is
  2852.                useful if you need to see the results of the command
  2853.                execution.
  2854.  
  2855.           %%   Insert an actual "%" into the command.
  2856.  
  2857.        Use [Ctrl-Enter] instead of [Enter] to start a macro and you will be
  2858.        able to see the prepared EXECute functions before they are executed
  2859.        by DOS.  {COMMO} will also wait before returning to the Terminal
  2860.        Screen so that you may see any error messages from the executing
  2861.        program.
  2862.  
  2863.  
  2864.        Examples:
  2865.  
  2866.           {exec dsz port %p speed %s sz %u\%i %a%w}
  2867.  
  2868.                {COMMO} will prepare the DSZ command by substituting the "%"
  2869.                parameters, then call DOS to execute the program.
  2870.  
  2871.                Note the "%i".  This will bring up the "Execute a DOS
  2872.                Command" window and prompt you for input (in this case, a
  2873.                filename).
  2874.  
  2875.                The alarm will sound at completion ("%a") and {COMMO} will
  2876.                wait for a keypress ("%w") before restoring the Terminal
  2877.                Screen.
  2878.  
  2879.           {exec list %c}
  2880.  
  2881.                The LIST program will be executed with the current Capture
  2882.                File as a command line argument.  {COMMO} will return
  2883.                immediately to the Terminal Screen when LIST exits.
  2884.  
  2885.  
  2886.        EXED
  2887.        ----
  2888.        Default key: none
  2889.        Description: Execute an external program directly.
  2890.  
  2891.  
  2892.  
  2893.                    {COMMO} (tm)  User Guide and Reference           page 50
  2894.  
  2895.  
  2896.        Use this function to execute .EXE and .COM programs without the use
  2897.        of the command processor (COMMAND.COM).  There are several
  2898.        advantages to this:
  2899.  
  2900.           1)   Only the memory needed to run the program must be available
  2901.                (the command processor requires that 32k or more be
  2902.                available when it is run).
  2903.  
  2904.           2)   About 4k of memory is saved by not having a copy of the
  2905.                command processor resident when the program is executed.
  2906.  
  2907.           3)   The program executes faster, since COMMAND.COM is not loaded
  2908.                from disk.
  2909.  
  2910.           4)   The program's exit code is preserved and may be tested with
  2911.                the {COMMO} IFERrorlevel function.
  2912.  
  2913.        Two important rules must be followed when using EXED:
  2914.  
  2915.           1)   The full pathname of the program file must be specified,
  2916.                including the path where the file resides on disk and the
  2917.                file extension.  For example:
  2918.  
  2919.                     {exed c:\util\list.com %c}
  2920.  
  2921.           2)   Only .EXE and .COM files may be run with EXED (batch files
  2922.                and internal DOS commands cannot be executed without the
  2923.                command processor, use EXEC or EXEN).
  2924.  
  2925.        In all other respects EXED is the same as EXECute, including the use
  2926.        of all "%" parameters.
  2927.  
  2928.  
  2929.        EXEN
  2930.        ----
  2931.        Default key: none
  2932.        Description: Execute a DOS command, do not clear the screen.
  2933.  
  2934.        This function is exactly the same as EXECute, but the Terminal
  2935.        Screen is not cleared when the command is sent to DOS.  It is used
  2936.        to produce a smoother transition when programs or DOS commands
  2937.        execute rapidly.
  2938.  
  2939.        Examples:
  2940.  
  2941.           {exen del c:\commo\commo.cap}
  2942.           {exen ren commo.cap joes-bbs.cap}
  2943.  
  2944.  
  2945.  
  2946.                    {COMMO} (tm)  User Guide and Reference           page 51
  2947.  
  2948.  
  2949.        EXIT
  2950.        ----
  2951.        Default key: Alt-X
  2952.        Description: Exit {COMMO}.
  2953.  
  2954.        Example:
  2955.  
  2956.           {exit}              No arguments (return code = 0).
  2957.           {exit 3}            With return code.
  2958.  
  2959.        The return code will be passed to DOS.  It may be tested with the IF
  2960.        ERRORLEVEL batch command.  Range is 0 to 255.
  2961.  
  2962.  
  2963.        GOLOok
  2964.        ------
  2965.        Default key: none
  2966.        Description: Set a macro-id to GOTO if a string comes in during a
  2967.                     subsequent LOOKfor function.
  2968.  
  2969.        Example construct:
  2970.  
  2971.                     {setlook 60,hng,3,n|}
  2972.                       ...
  2973.  
  2974.           {mac}     {golook aaa,string1}
  2975.                     {golook ,string2}
  2976.                     {golook bbb,string3}
  2977.                     {lookfor string4} {send answer4|} {goto ccc}
  2978.  
  2979.           {aaa}     {send answer1|} {goto mac}
  2980.           {bbb}     {call xyz} {goto mac}
  2981.  
  2982.           {ccc}       ...
  2983.  
  2984.        In this example {COMMO} will look for four strings.  When any string
  2985.        comes in, the LOOKfor is terminated (all strings are cancelled).  It
  2986.        may be set up again by going back to "mac."
  2987.  
  2988.        The GOLOok functions for string1 and string3 will GOTO "aaa" or
  2989.        "bbb" respectively if one of the strings comes in.  In the example
  2990.        control returns to "mac" and the four strings will continue to be
  2991.        looked for.
  2992.  
  2993.        The GOLOok for string2 has a null macro-id and control will pass to
  2994.        the function following the LOOKfor if the string comes in.  The ","
  2995.        must be present.
  2996.  
  2997.        If string4 comes in, control will also pass to the function
  2998.        following the LOOKfor.
  2999.  
  3000.        Tips on using the GOLOok function:
  3001.  
  3002.  
  3003.  
  3004.                    {COMMO} (tm)  User Guide and Reference           page 52
  3005.  
  3006.  
  3007.  
  3008.           GOLOok functions should immediately precede a LOOKfor (no string
  3009.           compares actually occur until the LOOKfor executes).  Up to 15
  3010.           GOLOoks may be used for a total of up to 16 strings to scan for.
  3011.  
  3012.           If two or more strings cause a match at the same time, the LAST
  3013.           such string listed is the one acted upon.  For example, when
  3014.           "abcdef" and "def" are listed and "abcdef" comes in.
  3015.  
  3016.           Since the LOOKfor is terminated whenever any of the strings come
  3017.           in (or when the LOOKfor timeout expires), this structure is
  3018.           unrestricted -- that is, CALLs, GOTOs, other GOLOok/LOOKfor
  3019.           constructs, etc., may be used freely in any of the branches.
  3020.  
  3021.           See the PUSHstack function for an example showing how to improve
  3022.           the structure of the GOLOok/LOOKfor sequence.
  3023.  
  3024.        See also "TIPS on creating LOOKfor strings" in the section
  3025.        describing the LOOKfor function.
  3026.  
  3027.        See also: LOOKfor, SETLook, PUSHstack, POPStack.
  3028.  
  3029.  
  3030.        GOTO
  3031.        ----
  3032.        Default key: none
  3033.        Description: Transfer control to a macro-id.
  3034.  
  3035.        Example:
  3036.  
  3037.           {goto x21}          Control transferred to macro-id "x21".
  3038.  
  3039.  
  3040.        HANGup
  3041.        ------
  3042.        Default key: Alt-Q
  3043.        Description: Disconnect by dropping DTR.
  3044.  
  3045.        Examples:
  3046.  
  3047.           {hangup}            Prompt user for disconnect.
  3048.           {hangup y}          Disconnect without prompting.
  3049.  
  3050.  
  3051.        HELP
  3052.        ----
  3053.        Default key: Alt-H
  3054.        Description: Open Online Help window.
  3055.  
  3056.        Example:
  3057.  
  3058.           {help}              Display topic 00
  3059.  
  3060.  
  3061.  
  3062.                    {COMMO} (tm)  User Guide and Reference           page 53
  3063.  
  3064.  
  3065.           {help 5}            Display topic 05
  3066.  
  3067.        Topic numbers may range from 00 to 99.  You may create your own
  3068.        Online Help file.  See "Modifying the Help File."
  3069.  
  3070.  
  3071.        HOLD
  3072.        ----
  3073.        Default key: none
  3074.        Description: Hold until specified time of day (24 hour format).
  3075.  
  3076.        Examples:
  3077.  
  3078.           {hold 3:30}         Hold until 3:30 am.
  3079.           {hold 16:10}        Hold until 4:10 pm.
  3080.           {hold 0:00}         Hold until midnight.
  3081.  
  3082.  
  3083.        IFCArrier
  3084.        ---------
  3085.        Default key: none
  3086.        Description: Test for presence of carrier detect signal.
  3087.  
  3088.        General form:
  3089.  
  3090.           {IFCArrier true-id,false-id}
  3091.  
  3092.                true-id        A macro-id to GOTO if carrier is detected.
  3093.  
  3094.                false-id       A macro-id to GOTO if carrier is not
  3095.                               detected.
  3096.  
  3097.                NOTE:     The default when either macro-id is omitted is to
  3098.                          pass control to the next function.
  3099.  
  3100.        Example:
  3101.  
  3102.                {ifcarrier c10,c20}
  3103.  
  3104.  
  3105.        IFERrorlevel
  3106.        ------------
  3107.        Default key: none
  3108.        Description: Test the exit code of an EXED function.
  3109.  
  3110.        General form:
  3111.  
  3112.           {IFERrorlevel number,true-id,false-id}
  3113.  
  3114.                number         A number from 0 to 255.  It will be compared
  3115.                               to the exit code from the last EXED function.
  3116.  
  3117.  
  3118.  
  3119.                    {COMMO} (tm)  User Guide and Reference           page 54
  3120.  
  3121.  
  3122.                true-id        A macro-id to GOTO if the exit code is
  3123.                               greater than or equal to "number."
  3124.  
  3125.                false-id       A macro-id to GOTO if the exit code is less
  3126.                               than "number."
  3127.  
  3128.                NOTE:     The default when either macro-id is omitted is to
  3129.                          pass control to the next function.
  3130.  
  3131.        Examples:
  3132.  
  3133.                {iferror 1,abc,def}
  3134.                {iferror 5,abc}
  3135.                {ifer 2,,def}
  3136.  
  3137.        The exit code may be tested repeatedly if necessary.
  3138.  
  3139.        Many programs return an exit code greater than 0 when the result is
  3140.        unsuccessful.  DSZ, for example, will return an exit code of 1 if
  3141.        the file transfer has failed.
  3142.  
  3143.        This test is meaningful only following an EXED function.  EXEC, EXEN
  3144.        or Shell to DOS will normally set the exit code to 0.
  3145.  
  3146.  
  3147.        IFEXist
  3148.        -------
  3149.        Default key: none
  3150.        Description: Test for existence of a disk file or files.
  3151.  
  3152.        General form:
  3153.  
  3154.           {IFEXist pathname,true-id,false-id}
  3155.  
  3156.                pathname       A DOS pathname.  If the path is omitted, the
  3157.                               current directory will be used.  If wildcards
  3158.                               are used the "true" condition will hold if
  3159.                               any files match the specification.
  3160.  
  3161.                true-id        A macro-id to GOTO if the file exists.
  3162.  
  3163.                false-id       A macro-id to GOTO if no files match.
  3164.  
  3165.                NOTE:     The default when either macro-id is omitted is to
  3166.                          pass control to the next function.
  3167.  
  3168.        Examples:
  3169.  
  3170.           {ifex a:file.xyz,,m20}             GOTO "m20" if not found.
  3171.           {ifex c:\data\words.txt,345}       GOTO "345" if found.
  3172.           {ifex c:\ul\*.rep,a01,a02}         Using a wildcard.
  3173.  
  3174.  
  3175.  
  3176.                    {COMMO} (tm)  User Guide and Reference           page 55
  3177.  
  3178.  
  3179.  
  3180.        INITmodem
  3181.        ---------
  3182.        Default key: Alt-O
  3183.        Description: Send Modem Initialization String.
  3184.  
  3185.        Example:
  3186.  
  3187.           {init}              No arguments
  3188.  
  3189.  
  3190.        LIGHts
  3191.        ------
  3192.        Default key: Alt-0
  3193.        Description: Set Signal Lights toggle.
  3194.  
  3195.        Examples:
  3196.  
  3197.           {lights}            Toggle Signal Lights on/off.
  3198.           {lights y}          Turn on Signal Lights.
  3199.           {lights n}          Turn off Signal Lights.
  3200.  
  3201.  
  3202.        LOCAlecho
  3203.        ---------
  3204.        Default key: Alt-6
  3205.        Description: Set Local Echo toggle.
  3206.  
  3207.        Examples:
  3208.  
  3209.           {local}             Toggle Local Echo on/off.
  3210.           {local y}           Turn on Local Echo.
  3211.           {local n}           Turn off Local Echo.
  3212.  
  3213.  
  3214.        LOOKfor
  3215.        -------
  3216.        Default key: none
  3217.        Description: Look for a string in the modem input stream.
  3218.  
  3219.        Examples:
  3220.  
  3221.           {setlook 60,abc,4,n|}    Set parameters.
  3222.           {lookfor first name?}    Look for the string "first name?"
  3223.           {look ^(COMMO^)}         Look for the string "{COMMO}".
  3224.  
  3225.  
  3226.        Parameters controlling LOOKfor execution are set with the SETLook
  3227.        function, which should be executed before any LOOKfor functions. 
  3228.        See the description of the SETLook function for details.
  3229.  
  3230.  
  3231.  
  3232.                    {COMMO} (tm)  User Guide and Reference           page 56
  3233.  
  3234.  
  3235.        The LOOKfor function will scan for the requested string to appear,
  3236.        then macro execution will continue with the next function.
  3237.  
  3238.        Use the GOLOok function to scan simultaneously for up to 15
  3239.        additional strings during a LOOKfor.
  3240.  
  3241.        TIPS on creating LOOKfor (and GOLOok) strings:
  3242.  
  3243.           There should be just one space following the LOOKfor function
  3244.           name.  Any spaces beyond this point are part of the string.  The
  3245.           string ends at the right curly brace.
  3246.  
  3247.           GOLOok and Auto Receive strings begin after the comma following
  3248.           the macro-id.  There should be no spaces unless they are part of
  3249.           the string.
  3250.  
  3251.           Strings may be up to 32 characters in length (control characters
  3252.           like "^M" count as one).  Upper/lower case is ignored.
  3253.  
  3254.           ANSI control sequences are filtered if ANSI or VT102 emulation is
  3255.           enabled.
  3256.  
  3257.           Remember that short strings may not be unique enough, long
  3258.           strings may not match due to line noise.
  3259.  
  3260.           Rules for representing special characters in LOOKfor strings are
  3261.           given in Appendix D "ASCII Character Representation."
  3262.  
  3263.        See also: GOLOok, SETLook.
  3264.  
  3265.  
  3266.        MACLoad
  3267.        -------
  3268.        Default key: none
  3269.        Description: Load a new Macro File.
  3270.  
  3271.        General form:
  3272.  
  3273.           {MACLoad filename,macro-id,r}
  3274.  
  3275.                filename       The new Macro File.  Do not specify a path;
  3276.                               the {COMMO} home directory will be used.
  3277.  
  3278.                macro-id       A macro-id to GOTO when the new file is
  3279.                               loaded.  Optional.
  3280.  
  3281.                r              Specifies that COMMO.MAC will be reloaded 
  3282.                               when carrier detect is lost.  Normally this
  3283.                               would occur at the end of the call. 
  3284.                               Optional. 
  3285.  
  3286.        Examples:
  3287.  
  3288.  
  3289.  
  3290.                    {COMMO} (tm)  User Guide and Reference           page 57
  3291.  
  3292.  
  3293.  
  3294.           {macload vt102-1.mac,,r}      Load vt102-1.mac, reload COMMO.MAC
  3295.                                         at the end of the call.
  3296.  
  3297.           {macl newmac.fil,abc}         Load newmac.fil, start macro "abc"
  3298.                                         in the new file.
  3299.  
  3300.  
  3301.        IMPORTANT: The new Macro File must reside in the {COMMO} home
  3302.        directory (do not specify a path).
  3303.  
  3304.        The current file will be saved to disk if changes are outstanding. 
  3305.        The new file is then loaded in place of the current one (all macros
  3306.        are replaced).  
  3307.  
  3308.        MACLoad should be the last function in a macro, since control is not
  3309.        returned.
  3310.  
  3311.  
  3312.        MACRo
  3313.        -----
  3314.        Default key: Alt-M
  3315.        Description: Open Macro Processor window.
  3316.  
  3317.        Example:
  3318.  
  3319.           {macro}             No arguments.
  3320.  
  3321.  
  3322.        MARK
  3323.        ----
  3324.        Default key: none
  3325.        Description: Mark Dialing Directory entries for dialing.
  3326.  
  3327.        Example:
  3328.  
  3329.           {mark joes-bbs,file-city}     Mark entries for dialing.
  3330.  
  3331.        Dialing Strings may be separated by spaces or commas.
  3332.  
  3333.        {COMMO} will search the Dialing Directory for each string and mark
  3334.        the first entry where a match is found.  Case is ignored.
  3335.  
  3336.        The strings may consist of any part of a Dialing Directory entry
  3337.        line (including passwords).  However the following characters may
  3338.        not appear in a macro Dialing String: space, comma, left or right
  3339.        curly brace. 
  3340.  
  3341.        See also: DIAL, UNMArk.
  3342.  
  3343.  
  3344.  
  3345.                    {COMMO} (tm)  User Guide and Reference           page 58
  3346.  
  3347.  
  3348.        NOOP
  3349.        ----
  3350.        Default key: none
  3351.        Description: No-op function, does nothing
  3352.  
  3353.        Example:
  3354.  
  3355.           {noop}              No arguments.
  3356.  
  3357.  
  3358.        PARMs
  3359.        -----
  3360.        Default key: Alt-L
  3361.        Description: Set Serial Port Parameters
  3362.  
  3363.        General form:
  3364.  
  3365.           {PARMs speed,format,comport}
  3366.  
  3367.                speed          The bps rate, such as 9600.
  3368.                format         The data format, such as 8n1.
  3369.                comport        The serial port number.
  3370.  
  3371.        Examples:
  3372.  
  3373.           {parms 2400,8,1}         Set 2400 bps, 8n1, Com1.
  3374.  
  3375.           {parms ,,4}              Set Com4.
  3376.  
  3377.           {parms 19200,7o1}        Set 19200 bps, 7o1.
  3378.  
  3379.        Note that omitted parameters are not changed.
  3380.  
  3381.  
  3382.        PASSword
  3383.        --------
  3384.        Default key: Alt-P
  3385.        Description: Send current password.
  3386.  
  3387.        Example:
  3388.  
  3389.           {password}          No arguments.
  3390.  
  3391.        The current password is obtained from the Dialing Directory entry
  3392.        whenever a number is dialed.  If no password is specified no
  3393.        characters will be sent.
  3394.  
  3395.  
  3396.        PAUSe
  3397.        -----
  3398.        Default key: none
  3399.        Description: Pause for up to 999 seconds.
  3400.  
  3401.  
  3402.  
  3403.                    {COMMO} (tm)  User Guide and Reference           page 59
  3404.  
  3405.  
  3406.  
  3407.        Example:
  3408.  
  3409.           {pause 25}          Pause for 25 seconds.
  3410.  
  3411.  
  3412.        POPStack
  3413.        --------
  3414.        Default key: none
  3415.        Description: Pop an element from the macro stack.
  3416.  
  3417.        Example:
  3418.  
  3419.           {pops}              No arguments.
  3420.  
  3421.        POPStack throws away the top element on the macro stack.  This
  3422.        element would have been the target of the next RETUrn function.
  3423.  
  3424.        See PUSHstack for a more complete description of the use of this
  3425.        function.
  3426.  
  3427.        See also CALL, RETUrn, GOLOok, LOOKfor.
  3428.  
  3429.  
  3430.        PRINtlog
  3431.        --------
  3432.        Default key: Alt-2
  3433.        Description: Set Print Log toggle.
  3434.  
  3435.        Examples:
  3436.  
  3437.           {print}             Toggle Print Log on/off.
  3438.           {print y}           Turn on Print Log.
  3439.           {print n}           Turn off Print Log.
  3440.  
  3441.  
  3442.        PUSHstack
  3443.        ---------
  3444.        Default key: none
  3445.        Description: Push a return point onto the macro stack.
  3446.  
  3447.        Examples:
  3448.  
  3449.           {push}              Push the current location.
  3450.           {push abc}          Push the location "abc".
  3451.  
  3452.        When there are no arguments, the location pushed is the location of
  3453.        the PUSHstack function itself (i.e., it will be executed again when
  3454.        a RETUrn is encountered).
  3455.  
  3456.        Explanation:  Whenever a CALL is executed, the location of the
  3457.        function following the CALL (the "return point") is "pushed" onto
  3458.  
  3459.  
  3460.  
  3461.                    {COMMO} (tm)  User Guide and Reference           page 60
  3462.  
  3463.  
  3464.        the macro stack.  When a subsequent RETUrn is executed, the location
  3465.        at the top of the stack is "popped" and control is transferred to
  3466.        that location.  This allows "nesting" of CALLs and RETUrns.
  3467.  
  3468.        PUSHstack will push a return point onto the macro stack without
  3469.        transferring control to the location (control continues in
  3470.        sequence).  A subsequent RETUrn will transfer control to the
  3471.        location that was pushed.
  3472.  
  3473.        POPStack will remove the top stack element without transferring
  3474.        control to it (control continues in sequence).
  3475.  
  3476.        These functions may be used to set a return point for GOLOok/LOOKfor
  3477.        functions, so that the same GOLOok routines may be used in more than
  3478.        one macro.  They also help to create macros with improved structure.
  3479.  
  3480.        Here is a sample construct using PUSHstack and POPStack:
  3481.  
  3482.           {mmm} {call ggg} ...
  3483.            ...
  3484.           {ggg} ...
  3485.                 {pushstack}
  3486.                 {golook aaa,string1}
  3487.                 {golook bbb,string2}
  3488.                 {golook ccc,string3}
  3489.                 {lookfor string4} {send answer4}
  3490.                 {popstack} {return}
  3491.  
  3492.           {aaa} {send answer1} {return}
  3493.           {bbb} {send answer2} {return}
  3494.           {ccc} {send answer3} {return}
  3495.  
  3496.        If strings 1,2 or 3 come in, responses will be sent and control will
  3497.        RETUrn to the PUSHstack (and execute it again).  If string 4 comes
  3498.        in the element pushed will be discarded by the POPStack and control
  3499.        will return following the {call ggg}.
  3500.  
  3501.        See also CALL, RETUrn, GOLOok, LOOKfor.
  3502.  
  3503.  
  3504.        RETUrn
  3505.        ------
  3506.        Default key: none
  3507.        Description: Return from a CALLed macro.
  3508.  
  3509.        Example:
  3510.  
  3511.           {return}            No arguments.
  3512.  
  3513.        This function will return control to a location determined by the
  3514.        last CALL or PUSHstack function.  See PUSHstack for a more complete
  3515.        description of the use of CALL/RETUrn.
  3516.  
  3517.  
  3518.  
  3519.                    {COMMO} (tm)  User Guide and Reference           page 61
  3520.  
  3521.  
  3522.  
  3523.        Note: If a RETUrn is encountered and no CALL or PUSHstack has been
  3524.        executed, a STOP will occur.  This is useful in macros that are
  3525.        CALLed and are also used standalone (such as protocol file transfer
  3526.        macros).
  3527.  
  3528.        See also CALL, PUSHstack, POPStack.
  3529.  
  3530.  
  3531.        SCREen
  3532.        ------
  3533.        Default key: Alt-I
  3534.        Description: Screen Image Save.
  3535.  
  3536.        Examples:
  3537.  
  3538.           {screen}                 Open Screen Image Save window.
  3539.           {screen y}               Append screen image to current file.
  3540.           {screen y,commo.scn}     Append screen image to indicated file.
  3541.                                    (and change current pathname).
  3542.           {screen n,c:\file.xyz}   Change current screen image pathname
  3543.                                    (don't save screen to file).
  3544.  
  3545.  
  3546.        SCROllback
  3547.        ----------
  3548.        Default key: Alt-K
  3549.        Description: Display Scrollback Buffer
  3550.  
  3551.        Example:
  3552.  
  3553.           {scroll}            No arguments.
  3554.  
  3555.  
  3556.        SEND
  3557.        ----
  3558.        Default key: none
  3559.        Description: Send a string to the modem.
  3560.  
  3561.        Example:
  3562.  
  3563.           {send Fred|~~Brucker|~~#|}    Send my first and last name with
  3564.                                         carriage returns and 1 second
  3565.                                         delays, then send the current
  3566.                                         password and <cr>.
  3567.  
  3568.        Note: see Appendix D "ASCII Character Representation" for
  3569.        information on how to represent any character in a SEND function.
  3570.  
  3571.  
  3572.  
  3573.                    {COMMO} (tm)  User Guide and Reference           page 62
  3574.  
  3575.  
  3576.        SETLook
  3577.        -------
  3578.        Default key: none
  3579.        Description: Set parameters for LOOKfor functions.
  3580.  
  3581.        Example:
  3582.  
  3583.           {setl 60,abc,4,n|}       Set LOOKfor parameters
  3584.  
  3585.        60      LOOKfor timeout.  Maximum time in seconds to look for a
  3586.                string.  If the string is not found in the allotted time,
  3587.                the macro in the second argument will be started.  May be 0
  3588.                to 999.  "0" means forever.  
  3589.  
  3590.        abc     Timeout macro.  Macro to GOTO if the time in the first
  3591.                argument expires.  If no macro is specified or if the
  3592.                macro-id is invalid, control will pass to the function
  3593.                following the LOOKfor.
  3594.  
  3595.        4       Prompt timeout.  During a LOOKfor function unwanted prompts
  3596.                may appear like "Press any key" or "More [Y/n]", etc.  
  3597.                This argument is the time in seconds to wait at a prompt (no
  3598.                input from the modem) before sending the string in the
  3599.                fourth argument.  Usually you would send "|" or "n|".
  3600.  
  3601.                When the string is sent the process is restarted, allowing
  3602.                any number of prompts to be satisfied (until the LOOKfor
  3603.                itself is satisfied or times out).
  3604.  
  3605.                The timer will also be reset if any keys are typed while
  3606.                waiting.  This allows a manual response to a prompt which
  3607.                the macro does not handle.
  3608.  
  3609.                Make sure this value is high enough to give the host system
  3610.                time to "think" when it is in between prompts.  Some systems
  3611.                take longer to do things.  May be 0 to 999.  "0" means
  3612.                forever.
  3613.  
  3614.        n|      Prompt response.  String to send when the time in the third
  3615.                argument runs out.  May be up to 32 characters.
  3616.  
  3617.        The SETLook function will set parameters for any subsequent
  3618.        LOOKfor's.  SETLook may be executed at any time to modify the
  3619.        parameters.
  3620.  
  3621.        Default arguments are:      LOOKfor timeout     0 (forever)
  3622.                                    Timeout macro       none 
  3623.                                    Prompt timeout      0 (forever)
  3624.                                    Prompt response     none
  3625.  
  3626.        Null arguments in the SETLook function will revert to these
  3627.        defaults.
  3628.  
  3629.  
  3630.  
  3631.                    {COMMO} (tm)  User Guide and Reference           page 63
  3632.  
  3633.  
  3634.  
  3635.        See also: LOOKfor, GOLOok.
  3636.  
  3637.  
  3638.        SHELl
  3639.        -----
  3640.        Default key: Alt-S
  3641.        Description: Shell to DOS.
  3642.  
  3643.        Example:
  3644.  
  3645.           {shell}             No arguments.
  3646.  
  3647.  
  3648.        SOUNd
  3649.        -----
  3650.        Default key: Alt-3
  3651.        Description: Set Master Sound toggle.
  3652.  
  3653.        Examples:
  3654.  
  3655.           {sound}             Toggle Master Sound on/off.
  3656.           {sound y}           Turn on Master Sound.
  3657.           {sound n}           Turn off Master Sound.
  3658.  
  3659.  
  3660.        STATusline
  3661.        ----------
  3662.        Default key: none
  3663.        Description: Set Status Line toggle.
  3664.  
  3665.        IMPORTANT: The Status Line is {COMMO}'s instrument panel.  You
  3666.        should not turn it off until you are familiar with operating the
  3667.        program.
  3668.  
  3669.        Examples:
  3670.  
  3671.           {statusline}        Toggle Status Line on/off.
  3672.           {status y}          Turn on Status Line.
  3673.           {status n}          Turn off Status Line.
  3674.  
  3675.        When the Status Line is off (not visible), the bottom line of the
  3676.        display becomes part of the Terminal Screen.
  3677.  
  3678.        The STATusline function is ignored while in Chat Mode.
  3679.  
  3680.  
  3681.        STOP
  3682.        ----
  3683.        Default key: none
  3684.        Description: Halt macro execution.
  3685.  
  3686.  
  3687.  
  3688.                    {COMMO} (tm)  User Guide and Reference           page 64
  3689.  
  3690.  
  3691.        Examples:
  3692.  
  3693.           {stop}              No arguments.
  3694.           {}                  Short form.
  3695.  
  3696.        STOP always returns {COMMO} to manual operation in the Terminal
  3697.        Screen.  It should be used to end login macros.
  3698.  
  3699.  
  3700.        TERMinal
  3701.        --------
  3702.        Default key: none
  3703.        Description: Set Terminal Emulation Type.
  3704.  
  3705.        Example:
  3706.  
  3707.           {terminal V}        Set VT102 emulation.
  3708.           {term a}            Set ANSI-BBS emulation.
  3709.           {term t}            Set TTY emulation.
  3710.  
  3711.  
  3712.        UNMArk
  3713.        ------
  3714.        Default key: none
  3715.        Description: Unmark Dialing Directory entries.
  3716.  
  3717.        Example:
  3718.  
  3719.           {unmark joes-bbs,file-city}        Unmark listed entries.
  3720.           {unmark}                           Unmark all entries.
  3721.  
  3722.        See the description of the MARK function for the rules on writing
  3723.        macro Dialing Strings.
  3724.  
  3725.        See also: DIAL, MARK.
  3726.  
  3727.  
  3728.        VTCUr
  3729.        -----
  3730.        Default key: none
  3731.        Description: Define a VT102 cursor (arrow) key.
  3732.  
  3733.        Example:
  3734.  
  3735.           {vtcur ^[[A|^[OA}        Define up-arrow key strings.
  3736.  
  3737.        The first string is sent when cursor mode is active; the second
  3738.        string is sent when application mode is active (these modes are
  3739.        controlled by the host).
  3740.  
  3741.        The two strings must be separated by a "|".  Use "^m" for carriage
  3742.        return if necessary.
  3743.  
  3744.  
  3745.  
  3746.                    {COMMO} (tm)  User Guide and Reference           page 65
  3747.  
  3748.  
  3749.  
  3750.        See also VTPAd.
  3751.  
  3752.  
  3753.        VTPAd
  3754.        -----
  3755.        Default key: none
  3756.        Description: Define a VT102 keypad key.
  3757.  
  3758.        Example:
  3759.  
  3760.           {vtpad 5|^[Ou}           Define keypad "5" key strings.
  3761.  
  3762.        The first string is sent when numeric mode is active; the second
  3763.        string is sent when application mode is active (these modes are
  3764.        controlled by the host).
  3765.  
  3766.        The two strings must be separated by a "|".  Use "^m" for carriage
  3767.        return if necessary.
  3768.  
  3769.        See also VTCUr.
  3770.  
  3771.  
  3772.        =========================
  3773.        Table of {COMMO} Key-id's
  3774.        =========================
  3775.  
  3776.        Key-id's are also macro-id's with the added advantage that the macro
  3777.        can be started by pressing the associated key from the Terminal
  3778.        Screen.  Most "extended" keys may be assigned this way.  If the same
  3779.        key-id appears more than once, the first occurrence will be used. 
  3780.        Note that key-id's are case insensitive.  The caret (^) indicates
  3781.        the Ctrl key.
  3782.  
  3783.        Enhanced keyboard key-id's are listed below.
  3784.  
  3785.  
  3786.                Key Name     Key-id        Key Name     Key-id
  3787.                ________     ______        ________     ______
  3788.  
  3789.                Normal-F1     nf1   ...    Normal-F10    nf0
  3790.                Ctrl-F1       cf1   ...    Ctrl-F10      cf0
  3791.                Shift-F1      sf1   ...    Shift-F10     sf0
  3792.                Alt-F1        af1   ...    Alt-F10       af0
  3793.  
  3794.                Alt-A         ala   ...    Alt-Z         alz
  3795.                Alt-1         al1   ...    Alt-0         al0
  3796.                Alt =         al=          Alt -         al-
  3797.  
  3798.                Escape        esc          Grey *        gr*
  3799.                Grey -        gr-          Grey +        gr+
  3800.  
  3801.  
  3802.  
  3803.                    {COMMO} (tm)  User Guide and Reference           page 66
  3804.  
  3805.  
  3806.                Backspace     bsp          ^Backspace    cbs
  3807.                Tab           tab          Shift-tab     stb
  3808.                Enter         ent          ^Enter        cen
  3809.  
  3810.                Home          hom          End           end
  3811.                PgUp          pgu          PgDn          pgd
  3812.                Up-Arrow      upa          Down-Arrow    dna
  3813.                Left-Arrow    lfa          Right-Arrow   rta
  3814.                Insert        ins          Delete        del
  3815.  
  3816.                ^Home         chm          ^End          cnd
  3817.                ^PgUp         cpu          ^PgDn         cpd
  3818.                ^Right-Arrow  cra          ^Left-Arrow   cla
  3819.  
  3820.                Keypad-0      kp0   ...    Keypad-9      kp9
  3821.                Keypad-.      kp.          ^PrtSc        cpr
  3822.  
  3823.  
  3824.        Enhanced Keyboard Key-id's
  3825.        ==========================
  3826.  
  3827.                Normal-F11    nfa          Normal-F12    nfb
  3828.                Ctrl-F11      cfa          Ctrl-F12      cfb
  3829.                Shift-F11     sfa          Shift-F12     sfb
  3830.                Alt-F11       afa          Alt-F12       afb
  3831.  
  3832.                Alt-[         al[          Alt-]         al]
  3833.                Alt-;         al;          Alt-'         al'
  3834.                Alt-,         al<          Alt-.         al.
  3835.                Alt-/         al/          Alt-\         al\
  3836.                Alt-*         al*          Alt-`         al`
  3837.                Center Key    cky
  3838.  
  3839.        The Center Key is the Keypad 5 with Numlock off.
  3840.  
  3841.        The keys in the second group may also work with the 83-key keyboard
  3842.        if your BIOS supports the enhanced keyboard.  Try them.
  3843.  
  3844.  
  3845.        ==========   =====================
  3846.        Appendix A   Setting Up Your Modem
  3847.        ==========   =====================
  3848.  
  3849.        Please be aware that there are many different modems in use and that
  3850.        it is of the utmost importance that you configure your modem to work
  3851.        correctly with {COMMO}.  A few tips will be given here, but they are
  3852.        no substitute for the detailed installation instructions in your
  3853.        modem manual!
  3854.  
  3855.        When {COMMO} is started, a command string called the Modem
  3856.        Initialization String will be sent to the modem.  You must make
  3857.        certain that the correct string is set up in your Configuration
  3858.  
  3859.  
  3860.  
  3861.                    {COMMO} (tm)  User Guide and Reference           page 67
  3862.  
  3863.  
  3864.        File.  This string will perform part or all of the modem setup
  3865.        depending on the type of modem.  Examples will be given for the most
  3866.        common types.
  3867.  
  3868.        If your modem is external to your computer, be sure you have
  3869.        followed the installation instructions carefully and that the cable
  3870.        is connected to the computer's serial port.  It is wise to turn off
  3871.        power to the computer and the modem when connecting or disconnecting
  3872.        any cables.
  3873.  
  3874.        Also check Item 1 in the Configuration File -- the Serial Port
  3875.        Parameters.  This string consists of the default speed, data format
  3876.        and port number.  For example if you usually use your modem at 2400
  3877.        bps, data format 8n1, on Com1, your parameter string would be:
  3878.  
  3879.           {2400,8n1,1}
  3880.  
  3881.           _______________
  3882.  
  3883.           1200 bps Modems
  3884.           _______________
  3885.  
  3886.        Most 1200 bps modems have switches on them which must be set to
  3887.        provide the proper interaction with your computer and with {COMMO}. 
  3888.        Consult your modem manual concerning these switches and pay
  3889.        particular attention to the following:
  3890.  
  3891.           1)   Enable command recognition.  Allows the modem to recognize
  3892.                commands (dial, set registers, etc.).  Must be in the
  3893.                "enable" position or modem will be unusable.
  3894.  
  3895.           2)   Send result codes in English.  This switch should be set so
  3896.                that the modem will send verbal responses to commands
  3897.                instead of numbers.  This is usually controlled by a command
  3898.                also (such as ATV1).
  3899.  
  3900.           3)   Respond to DTR (data terminal ready).  This should NOT be in
  3901.                the "ignore" or "on all the time" position.  This switch
  3902.                allows the computer to signal the modem to hang up.
  3903.  
  3904.           4)   Respond to carrier detect or "allow true carrier."  This
  3905.                should NOT be set to the "on all the time" position.
  3906.  
  3907.        Here is an example Modem Initialization String which will set up a
  3908.        1200 bps modem and override the switch settings (if possible):
  3909.  
  3910.           {~AT S0=0 S7=60 E0 Q0 V1 X1 |}
  3911.  
  3912.        The most important command to check is the "X" command, since its
  3913.        function varies the most from modem to modem.  The "X" command
  3914.        determines which responses the modem will generate during dialing
  3915.        (e.g. CONNECT, BUSY, etc.).  It may also activate an additional
  3916.  
  3917.  
  3918.  
  3919.                    {COMMO} (tm)  User Guide and Reference           page 68
  3920.  
  3921.  
  3922.        modem feature such as automatic redialing which will interfere with
  3923.        {COMMO}'s own redialing procedure.
  3924.  
  3925.        Your modem manual gives a description for each level of the "X"
  3926.        command: X0, X1, X2, ... , etc.  Generally you want to use the
  3927.        highest level that does not activate undesirable features.  If you
  3928.        will be using {COMMO}'s AutoBaud feature you will need the extended
  3929.        connect responses such as CONNECT 1200.  Also the BUSY response
  3930.        should be provided if possible.  In any case you should modify the
  3931.        Modem Initialization String to work with your particular modem.
  3932.  
  3933.           ___________________
  3934.  
  3935.           2400 bps and higher
  3936.           ___________________
  3937.  
  3938.        Modems which operate at 2400 bps and higher generally have commands
  3939.        to replace the switches (see the section above if yours has
  3940.        switches).  These commands may be given every time you start {COMMO}
  3941.        or they may be permanently remembered by modems which have "non-
  3942.        volatile" memory.
  3943.  
  3944.        It will be assumed here that the commands are given every time you
  3945.        start {COMMO}.  If you wish to place the settings in non-volatile
  3946.        memory, consult your modem manual on how to do this.  Here is an
  3947.        example Modem Initialization String for 2400 bps (and most higher
  3948.        speed) modems:
  3949.  
  3950.           {~AT S0=0 S7=60 E0 Q0 V1 X4 &C1 &D2 |}
  3951.  
  3952.        See the comments above concerning the "X" command since they apply
  3953.        to these modems as well.
  3954.  
  3955.  
  3956.        If {COMMO} is already running you may edit the Configuration File
  3957.        with the Alt-G key command, change the Modem Initialization String,
  3958.        then use the Alt-O key command to send the string to the modem. 
  3959.        Normally the string is sent to the modem when {COMMO} is started.
  3960.  
  3961.           ___________________________________________
  3962.  
  3963.           Connecting two computers (null modem cable)
  3964.           ___________________________________________
  3965.  
  3966.        {COMMO} may be used on a "direct connection" between two computers
  3967.        or between a computer and another serial device.  Connect the two
  3968.        serial ports with a "null modem" cable (see below).  Then start the
  3969.        program on each computer, having selected the appropriate serial
  3970.        port parameters in the Configuration File(s).
  3971.  
  3972.        The null modem cable should be designed so that the transmit line on
  3973.        each end connects to the receive line on the other end.  No other
  3974.  
  3975.  
  3976.  
  3977.                    {COMMO} (tm)  User Guide and Reference           page 69
  3978.  
  3979.  
  3980.        signals are needed, but none of the RS-232C signals should be left
  3981.        "floating."  They should be tied high or low (or at least grounded).
  3982.  
  3983.        You may have to disable the Usage Log in the Configuration File by
  3984.        setting the path to null {}.  The log is triggered by changes in
  3985.        Carrier Detect and will slow things down if CD is unpredictable.
  3986.  
  3987.  
  3988.        ==========   =========================
  3989.        Appendix B   {COMMO} and Multi-Tasking
  3990.        ==========   =========================
  3991.  
  3992.           ________
  3993.  
  3994.           DESQview
  3995.           ________
  3996.  
  3997.        Special care has been taken to ensure that {COMMO} is compatible
  3998.        with Quarterdeck Office Systems' DESQview(tm), a multi-tasking
  3999.        supervisor.  DESQview allows more than one program to execute at the
  4000.        same time.
  4001.  
  4002.        A sample Program Information File (CO-PIF.DVP) has been included in
  4003.        the {COMMO} package for your convenience.  This file is installed as
  4004.        follows:
  4005.  
  4006.           1)   Copy the file to your DESQview directory (usually C:\DV).
  4007.           2)   Run "Add a Program" (AP) from the "Open Window" menu.
  4008.           3)   Select "Other."  Specify the DESQview directory as the
  4009.                "Path."
  4010.           4)   Mark the {COMMO} entry, press Enter.  "CO" should now appear
  4011.                on your "Open Window" menu.
  4012.  
  4013.        The CO-PIF.DVP file has been set up to define a 150k memory window. 
  4014.        The amount of memory actually required is affected by the size of
  4015.        your COMMO.FON file, your COMMO.MAC file and the size of your
  4016.        Scrollback buffer.
  4017.  
  4018.        Test the size of the window by running DSZ, LIST, etc., from the
  4019.        Macro Processor or Shell to DOS.  Be sure to test the execution of
  4020.        external programs with a "wait" at the end so that you can see any
  4021.        error messages (see EXEC function).
  4022.  
  4023.        CO-PIF.DVP can be changed with the "Change a Program" (CP) command
  4024.        on the "Open Window" menu.  You may also want to change the
  4025.        directory information or other parameters.
  4026.  
  4027.        TIPS on using {COMMO} with DESQview:
  4028.  
  4029.           For best performance the foreground and background "tick counts"
  4030.           should both be 10 or less.  This is particularly important in
  4031.           order for Auto Receive to function properly.
  4032.  
  4033.  
  4034.  
  4035.                    {COMMO} (tm)  User Guide and Reference           page 70
  4036.  
  4037.  
  4038.  
  4039.           If you switch to another task, do not attempt to access any files
  4040.           which may be in use in the {COMMO} window.  Examples are the
  4041.           Capture File, the Screen Image File and files that may be
  4042.           currently involved in a file transfer (upload or download).  The
  4043.           result may be a loss of part or all of the data in the file. 
  4044.           This is a general DESQview no-no.  You may freely access these
  4045.           files in the Shell to DOS or Macro Processor features of {COMMO}
  4046.           (within the same window).
  4047.  
  4048.           If the memory allocated to the window is too small, {COMMO} will
  4049.           not be able to load the Online Help file.  Since the Online Help
  4050.           file is loaded only when requested, you needn't be concerned if
  4051.           you don't intend to use it.
  4052.  
  4053.           The video display may seem less smooth in DESQview.  This is a
  4054.           result of {COMMO} using the fastest possible display method, and
  4055.           is quite normal.  This effect can be reduced by specifying fewer
  4056.           clock ticks for foreground and background (4 and 4 seems to work
  4057.           well). 
  4058.  
  4059.           The Snow Checking option should not be used when {COMMO} is run
  4060.           under DESQview.  If you see "snow" type interference in your CGA
  4061.           display, use DESQview's own snow checking (request "synchronized
  4062.           access" in the Setup program).
  4063.  
  4064.           ________
  4065.  
  4066.           OmniView
  4067.           ________
  4068.  
  4069.        Display bleed-through may be avoided by telling OmniView that
  4070.        {COMMO} "Supports TopView Functions" or by using the "/T" switch on
  4071.        the OmniView command line.
  4072.  
  4073.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  4074.        most of which apply to OmniView as well.
  4075.  
  4076.           _________
  4077.  
  4078.           DoubleDOS
  4079.           _________
  4080.  
  4081.        Color displays require the "DISPLAY = TEXT" option in DDCONFIG.SYS. 
  4082.        Run {COMMO} in the bottom partition -- about 130k to 150k should
  4083.        suffice if you plan to use Online Help and/or external protocols. 
  4084.        Increase this size in proportion to the size of your Scrollback
  4085.        buffer.
  4086.  
  4087.        Some non-multi-tasker-aware, direct-screen-writing programs executed
  4088.        with the Macro Processor or Shell to DOS may not display properly. 
  4089.        If this happens you may have to run {COMMO} in the top partition.
  4090.  
  4091.  
  4092.  
  4093.                    {COMMO} (tm)  User Guide and Reference           page 71
  4094.  
  4095.  
  4096.  
  4097.        Use the supplied DBLDANSI.SYS driver in place of your ANSI.SYS for
  4098.        running other programs in this partition ({COMMO} doesn't use it).
  4099.  
  4100.        With this setup you may run any non-graphics program in the top
  4101.        partition, including direct screen writers.  
  4102.  
  4103.        Monochrome displays require the REFRESH option in DDCONFIG.SYS. 
  4104.        Refer to the DoubleDOS user's manual for information on this.
  4105.  
  4106.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  4107.        most of which apply to DoubleDOS as well.
  4108.  
  4109.  
  4110.        ==========   ============
  4111.        Appendix C   Flow Control
  4112.        ==========   ============
  4113.  
  4114.        Flow Control is a signalling system used by communications devices
  4115.        to prevent data from being transmitted faster than it can be
  4116.        processed by the receiving system.  This is especially important
  4117.        when data is transferred at high speeds.
  4118.  
  4119.        Flow Control is activated from the Configuration File and is used by
  4120.        {COMMO} for both sending and receiving.  You may specify Software
  4121.        Flow Control, Hardware Flow Control or both.  Changes may be made at
  4122.        any time using the Internal Editor and will be effective immediately
  4123.        upon exiting the editor.
  4124.         
  4125.        Software Flow Control uses a control character called XOFF (or ^S)
  4126.        to signal the remote to pause.  XON (^Q) is the signal to "resume
  4127.        transmission."  This is normally used only for ASCII data, since
  4128.        these characters may appear randomly within binary data.  An XOFF
  4129.        pause will automatically be released in 20 seconds if no XON is
  4130.        received.  It will also be released if you type a character in the
  4131.        Terminal Screen.
  4132.  
  4133.        Hardware Flow Control uses the RTS/CTS lines in your RS-232C (serial
  4134.        port) cable to signal pause/resume without interfering with the
  4135.        data.  It should only be used when you are connected to a device
  4136.        which also recognizes RTS/CTS Flow Control (such as a high-speed
  4137.        modem or another computer connected with a null modem cable).  A
  4138.        CTS-off (send) pause will not be released automatically.  Turn off
  4139.        Hardware Flow Control (in the Configuration File) if you need to
  4140.        override it.
  4141.  
  4142.        TIPS on using Flow Control:
  4143.  
  4144.           Your modem must be properly initialized to utilize flow control
  4145.           (consult the manual for details).
  4146.  
  4147.  
  4148.  
  4149.                    {COMMO} (tm)  User Guide and Reference           page 72
  4150.  
  4151.  
  4152.           Since Software Flow Control uses the XOFF (ASCII 19) and XON
  4153.           (ASCII 17) characters, these will not display on the screen.  If
  4154.           it is necessary to display them, Software Flow Control must be
  4155.           turned off.
  4156.  
  4157.           It is especially important to use Flow Control when the Print Log
  4158.           is on, since data is usually received faster than it can be
  4159.           printed.  If you type a character to the remote during a flow
  4160.           control pause, the remote may begin sending again (some systems
  4161.           resume on any character, not just XON).  You may have to turn off
  4162.           the Print Log if this happens.
  4163.  
  4164.  
  4165.        ==========   ==============================
  4166.        Appendix D   ASCII Character Representation
  4167.        ==========   ==============================
  4168.  
  4169.        Sometimes it is necessary to enter special characters in the {COMMO}
  4170.        support files (Configuration File, Dialing Directory and Macro File)
  4171.        or as input to {COMMO} key commands.
  4172.  
  4173.        As an example, suppose you wanted to put a carriage return into a
  4174.        SEND macro function.  If you pressed the Enter key while typing into
  4175.        the Macro File, {COMMO} would think you simply wanted the cursor to
  4176.        go to the beginning of the next line.
  4177.  
  4178.        In other words, certain control characters are used in the operation
  4179.        of {COMMO} and need to be entered in a special way if they are to be
  4180.        used as data.  This section defines how to represent these
  4181.        characters as data.
  4182.  
  4183.  
  4184.        In general, Curly braces { } may ONLY appear as shown in the
  4185.        descriptions and examples for each of the support files.
  4186.  
  4187.  
  4188.        ASCII Data Strings
  4189.        __________________
  4190.  
  4191.        Strings of ASCII characters appear in many places in the {COMMO}
  4192.        support files, including:
  4193.  
  4194.           Modem initialization string        (Config. File)
  4195.           Dial prefixes                      (Config. File)
  4196.           Dial suffix                        (Config. File)
  4197.           Telephone number                   (Dialing Directory)
  4198.           Password string                    (Dialing Directory)
  4199.           Strings in macro functions such as
  4200.                SEND, SETLook and LOOKfor     (Macro File)
  4201.  
  4202.        Note that most of these are sent to the modem.
  4203.  
  4204.  
  4205.  
  4206.                    {COMMO} (tm)  User Guide and Reference           page 73
  4207.  
  4208.  
  4209.  
  4210.        The following characters have special significance in ASCII Data
  4211.        strings:
  4212.  
  4213.           The vertical bar (|) represents a carriage return.
  4214.  
  4215.           The tilde (~) forces a one-half second delay (modem output only).
  4216.  
  4217.           The pound sign (#) will cause the current Password String to be
  4218.           sent in its place (in the SEND function only).
  4219.  
  4220.  
  4221.        Every character in the extended ASCII chart may be represented:
  4222.  
  4223.           The caret (^) is used to represent ASCII values which may not be 
  4224.           entered from the keyboard:
  4225.  
  4226.             0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  4227.             1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  4228.             2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  4229.             3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  4230.             4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  4231.             5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  4232.             6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  4233.  
  4234.           The caret (^) is also used to represent the following:
  4235.  
  4236.             {  ... ^(      the left curly brace
  4237.             }  ... ^)      the right curly brace
  4238.             |  ... ^|      the vertical bar
  4239.             ~  ... ^~      the tilde
  4240.             #  ... ^#      the pound sign
  4241.             ^  ... ^^      the caret
  4242.  
  4243.        These particular characters should only appear in this form, while
  4244.        others such as ASCII 28 through 31 and those in the upper 128
  4245.        extended character set may be typed using the Alt-numeric-keypad
  4246.        method as follows:
  4247.  
  4248.           1. Hold down the Alt key (and keep it down).
  4249.  
  4250.           2. Enter the ASCII code in decimal using the numeric keypad keys
  4251.              (1, 2 or 3 digits are ok).
  4252.  
  4253.           3. Release the Alt key.
  4254.  
  4255.        ASCII 28 through 31 may also be typed using the Ctrl key on your
  4256.        keyboard:
  4257.  
  4258.             28 ... Ctrl \
  4259.             29 ... Ctrl ]
  4260.             30 ... Ctrl 6
  4261.  
  4262.  
  4263.  
  4264.                    {COMMO} (tm)  User Guide and Reference           page 74
  4265.  
  4266.  
  4267.             31 ... Ctrl -
  4268.  
  4269.        All other characters are entered in the usual manner.
  4270.  
  4271.  
  4272.        ==========   ==================
  4273.        Appendix E   Terminal Emulation
  4274.        ==========   ==================
  4275.  
  4276.        Terminal Emulation Type is indicated on the status line (to the
  4277.        right of the Serial Port Parameters string).  Available types are:
  4278.  
  4279.                A   ANSI-BBS   Used on bulletin boards and other systems.
  4280.                V   VT102      Used on minicomputers and mainframes.
  4281.                T   TTY        Supports only the basic control characters.
  4282.  
  4283.        The default Terminal Emulation Type (as defined in the Configuration
  4284.        File) will be set whenever a system is dialed.  It may be changed
  4285.        temporarily using the Alt-L key command or the TERMinal macro
  4286.        function.
  4287.  
  4288.        TIPS on using terminal emulation:
  4289.  
  4290.           Whenever a change is made, a reset of mode parameters will be
  4291.           performed.  It is therefore important that the change be made
  4292.           BEFORE (or at the time of) connecting with a host (mode settings
  4293.           may be transmitted by the host).
  4294.  
  4295.           If some screens do not look right when VT102 emulation is used,
  4296.           you may need to turn LINEWRAP off (it defaults to on).
  4297.  
  4298.           Linewrap may be turned on/off locally using the DISPlay macro
  4299.           function.  Place one of the following in your login macro (or
  4300.           assign one of them to a key and execute it manually):
  4301.  
  4302.                     {display ,,,^[[?7h}      linewrap ON
  4303.                     {display ,,,^[[?7l}      linewrap OFF
  4304.  
  4305.           If colors do not always look right, it may be necessary to set
  4306.           the Terminal Screen colors in the Configuration File to {07}. 
  4307.           See the note under "Colors" in the Configuration File section.
  4308.  
  4309.  
  4310.        Printer Support
  4311.        ===============
  4312.  
  4313.        {COMMO} supports the ANSI/VT102 printer functions, controlled by the
  4314.        remote system.  The "Printer ON/OFF" function will turn {COMMO}'s
  4315.        Print Log ON/OFF.  The "Dedicated Printing" function will send all
  4316.        input from the serial port directly to the printer.  This allows for
  4317.        "transparent" transmission of printer data, including control codes. 
  4318.        The "Print Screen" function will print the entire current screen.
  4319.  
  4320.  
  4321.  
  4322.                    {COMMO} (tm)  User Guide and Reference           page 75
  4323.  
  4324.  
  4325.  
  4326.        The printer should be on and ready to print when these functions are
  4327.        used.  When "Dedicated Printing" is active no characters will be
  4328.        displayed on the screen.
  4329.  
  4330.  
  4331.        ANSI-BBS Keyboard Support
  4332.        =========================
  4333.  
  4334.        The sample Macro File is set up so you can use the PC keypad keys
  4335.        (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors.
  4336.  
  4337.  
  4338.        VT102 Keyboard Simulation
  4339.        =========================
  4340.  
  4341.        Two keyboard files, VT102-1.MAC and VT102-2.MAC, provide support to
  4342.        simulate the VT102 keyboard.  You may merge one of these into
  4343.        COMMO.MAC if you intend to use VT102 all the time (replace the ANSI-
  4344.        BBS keys).  Be sure that you have no conflicting key-id's (remember
  4345.        that {COMMO} will use the first occurrence of a key-id).
  4346.  
  4347.        Or you can use the MACLoad function in your login macro to load the
  4348.        VT102 file automatically when you connect to the host.  Using the
  4349.        "r" option of MACLoad will reload COMMO.MAC at disconnect.  For
  4350.        example:
  4351.  
  4352.           {macload vt102-1.mac,,r}
  4353.  
  4354.        Both files support the following PC keypad functions (^ indicates
  4355.        the Ctrl key):
  4356.  
  4357.                Four cursor (arrow) keys
  4358.                Home   - Home cursor
  4359.                ^Home  - Insert line
  4360.                PgUp   - Page up
  4361.                ^PgUp  - Delete line
  4362.                PgDn   - Page down
  4363.                ^PgDn  - Clear screen
  4364.                End    - End of line
  4365.                Ins    - Insert mode
  4366.                Del    - Delete
  4367.                ^bs   -  Ctrl backspace (delete)
  4368.  
  4369.        VT102 numeric keypad keys are auto-switched by the host system
  4370.        between numeric mode and application mode.
  4371.  
  4372.        The four cursor keys are auto-switched between cursor mode and
  4373.        application mode.
  4374.  
  4375.  
  4376.  
  4377.                    {COMMO} (tm)  User Guide and Reference           page 76
  4378.  
  4379.  
  4380.        These files may be modified to create any keyboard support you
  4381.        desire (see description of VTCUr and VTPAd functions in the section
  4382.        "{COMMO} Macro Functions."
  4383.  
  4384.           ___________
  4385.  
  4386.           VT102-1.MAC
  4387.           ___________
  4388.  
  4389.        This file contains keyboard assignments that work best with the
  4390.        enhanced keyboard (because of the separate cursor keys, etc.).
  4391.  
  4392.        With Numlock ON the ten digits and period will simulate their
  4393.        equivalent VT102 functions.  In addition:
  4394.  
  4395.                F1 to F4 simulate PF1 to PF4
  4396.                Grey * is used for comma
  4397.                Grey - is used for dash
  4398.                Grey + is used for Enter
  4399.  
  4400.           ___________
  4401.  
  4402.           VT102-2.MAC
  4403.           ___________
  4404.  
  4405.        This file contains keyboard assignments that work best with the 83-
  4406.        key keyboard (because of the location of the function keys on the
  4407.        left side).
  4408.  
  4409.        The following diagram shows how the ten function keys (Fn) and ten
  4410.        shifted function keys (SFn) relate to the VT102 keypad keys:
  4411.  
  4412.  
  4413.                F1=  PF1    F2=  PF2    SF1=  PF3    SF2=  PF4
  4414.  
  4415.                F3=   7     F4=   8     SF3=   9     SF4=   -
  4416.  
  4417.                F5=   4     F6=   5     SF5=   6     SF6=   ,
  4418.         
  4419.                F7=   1     F8=   2     SF7=   3     SF8=   Enter
  4420.  
  4421.                F9=   0     F10=  0     SF9=   .     SF10=  Enter
  4422.  
  4423.  
  4424.        ==========   ==========================
  4425.        Appendix F   Error Message Explanations
  4426.        ==========   ==========================
  4427.  
  4428.        If you get an error message that you don't understand, check below
  4429.        for additional information.
  4430.  
  4431.  
  4432.  
  4433.                    {COMMO} (tm)  User Guide and Reference           page 77
  4434.  
  4435.  
  4436.        __________________________
  4437.  
  4438.        Wrong number of braces { }
  4439.        __________________________
  4440.  
  4441.           The Configuration File does not have the correct number of
  4442.           strings (items), or the left and right curly braces are not
  4443.           present in matched pairs.  If necessary compare the file with the
  4444.           original one in the {COMMO} package.
  4445.  
  4446.           If you get this message at program startup, check your "SET
  4447.           COMMO=" command in your AUTOEXEC.BAT file.  It may be specifying
  4448.           a directory that has an old version of COMMO.CFG.
  4449.  
  4450.        ________________________________
  4451.  
  4452.        Sorry, out of memory
  4453.        Not enough memory for Scrollback
  4454.        ________________________________
  4455.  
  4456.           These messages may occur at program startup.  Check the
  4457.           following:
  4458.  
  4459.           1)   {COMMO} cannot allocate its internal buffers.  You must make
  4460.                more memory available.
  4461.  
  4462.           2)   {COMMO} cannot load the Dialing Directory and/or Macro File. 
  4463.                Try reducing the size of either of these files.  Removing
  4464.                comments may help.  Or make more memory available.
  4465.  
  4466.           3)   {COMMO} cannot allocate the Scrollback Buffer.  Reduce its
  4467.                size or make more memory available.
  4468.  
  4469.        _______________________________
  4470.  
  4471.        Cannot locate command processor
  4472.        _______________________________
  4473.  
  4474.           This is an unusual condition.  Type "SET" at the DOS prompt and
  4475.           be sure there is a "COMSPEC=" in the list.  If there is, make
  4476.           sure that COMMAND.COM is in the path specified.
  4477.  
  4478.        _______________________________   
  4479.  
  4480.        Check your "SET COMMO=" command
  4481.        _______________________________
  4482.  
  4483.           1)   The Configuration File cannot be located or it has the wrong
  4484.                number of braces.  Make sure your "SET COMMO=" points to the
  4485.                correct disk/directory.
  4486.  
  4487.  
  4488.  
  4489.                    {COMMO} (tm)  User Guide and Reference           page 78
  4490.  
  4491.  
  4492.           2)   The path located in the system environment is too long.  Do
  4493.                another "SET COMMO=" command to correct this.
  4494.  
  4495.        ___________________________________________
  4496.  
  4497.        WARNING: another copy of {COMMO} is running
  4498.        ___________________________________________
  4499.  
  4500.        This message lets you know that you have at least one other copy of
  4501.        {COMMO} resident in your computer.  If possible you should exit back
  4502.        to that copy to avoid losing changes to your support files.
  4503.  
  4504.        _______________________
  4505.  
  4506.        Not enough memory
  4507.        Program file not found
  4508.        Unable to execute shell
  4509.        _______________________
  4510.  
  4511.           A problem was encountered during Shell to DOS, EXEC, EXEN or
  4512.           EXED:
  4513.  
  4514.           1)   There may not be enough memory to execute the command
  4515.                processor or external program you have specified.
  4516.  
  4517.           2)   The program file you specified in an EXED function cannot be
  4518.                located.  Make sure you specify the full path and filename.
  4519.  
  4520.           3)   Some other system error condition may exist.  Make sure that
  4521.                COMMAND.COM is still available in the "COMSPEC=" path.
  4522.  
  4523.        ___________________________
  4524.  
  4525.        Hardware flow control pause
  4526.        ___________________________
  4527.  
  4528.           Hardware Flow Control is in effect and the remote system (or your
  4529.           modem) has requested a pause.  Try waiting a few seconds for the
  4530.           pause to clear; if that fails you may have to turn off Hardware
  4531.           Flow Control (in the Configuration File).
  4532.  
  4533.        _________________________________________
  4534.  
  4535.        File space full!  Delete unnecessary text
  4536.        _________________________________________
  4537.  
  4538.           {COMMO} allows about 65,000 bytes when editing any file (the
  4539.           Dialing Directory and Macro File occupy a common file space). 
  4540.           This limit may be reached when editing any of the files with the
  4541.           Internal Editor.  If this happens you must reduce the size of the
  4542.           file in question.  Try removing comment lines and any other
  4543.           extraneous information.
  4544.  
  4545.  
  4546.  
  4547.                    {COMMO} (tm)  User Guide and Reference           page 79
  4548.  
  4549.  
  4550.  
  4551.           This message may also be the result of loading a resident program
  4552.           (TSR) in the Shell to DOS or via the EXEC macro function.  Other
  4553.           causes involve a corruption of DOS parameters and require
  4554.           rebooting.
  4555.  
  4556.        _____________________
  4557.  
  4558.        Dial command too long
  4559.        _____________________
  4560.  
  4561.           The dial command consists of the dial prefix, the phone number
  4562.           string and the dial suffix.  The total is limited to 72
  4563.           characters.
  4564.  
  4565.        _______________________
  4566.  
  4567.        Bad parameter after "%"
  4568.        _______________________
  4569.  
  4570.           Allowable parameters are listed in the description of the "EXEC"
  4571.           macro function.
  4572.  
  4573.        ________________________
  4574.  
  4575.        Command too long for DOS
  4576.        ________________________
  4577.  
  4578.           DOS commands are limited to 127 characters.
  4579.  
  4580.        ________________________________
  4581.  
  4582.        Unable to open file
  4583.        Unable to open Help File
  4584.        Unable to open Capture File
  4585.        Unable to open Screen Image File
  4586.        File not found
  4587.        Path not found
  4588.        Too many files
  4589.        ________________________________
  4590.  
  4591.           Check the following:
  4592.  
  4593.           1)   That the path exists where the file should be.
  4594.           2)   That the file itself exists (this won't be the problem if
  4595.                the file is being created).
  4596.           3)   Too many files may be open.  You may need to increase your
  4597.                FILES= parameter in CONFIG.SYS.
  4598.           4)   The Online Help File must be less than 64K bytes in size.
  4599.           5)   You cannot use an open Capture File for any other purpose.
  4600.  
  4601.  
  4602.  
  4603.                    {COMMO} (tm)  User Guide and Reference           page 80
  4604.  
  4605.  
  4606.        _____________________________________
  4607.  
  4608.        Closing Capture File, disk is full!
  4609.        Screen Image not saved, disk is full!
  4610.        _____________________________________
  4611.  
  4612.           These files should be edited regularly to ensure that they are
  4613.           not occupying too much disk space.
  4614.  
  4615.  
  4616.                                    - end -
  4617.  
  4618.